MCP Server for Odoo
Configuration
View docs{
"mcpServers": {
"tuanle96-mcp-odoo": {
"command": "python",
"args": [
"-m",
"odoo_mcp"
],
"env": {
"ODOO_DB": "your-database-name",
"ODOO_URL": "https://your-odoo-instance.com",
"ODOO_PASSWORD": "your-password-or-api-key",
"ODOO_USERNAME": "your-username"
}
}
}
}You gain an MCP server that bridges Odoo ERP data and actions to AI assistants. It gives you programmatic access to Odoo models, records, and methods via a simple, extensible interface, enabling powered interactions while keeping your data flow clean and stateless.
You connect to the Odoo MCP Server from your MCP client and issue high-level actions that map to Odoo operations. Use the available tools to search for employees and holidays, or execute custom methods on Odoo models. The server handles authentication, data access, and error reporting, returning structured results you can consume in your AI workflows.
{
"mcpServers": {
"odoo": {
"command": "python",
"args": [
"-m",
"odoo_mcp"
],
"env": {
"ODOO_URL": "https://your-odoo-instance.com",
"ODOO_DB": "your-database-name",
"ODOO_USERNAME": "your-username",
"ODOO_PASSWORD": "your-password-or-api-key"
}
}
}
}Prerequisites - Python 3.x installed on your system - Access to an Odoo instance with API credentials - Optional: Docker if you want to run the server in a container
Configuration and runtime options are provided by the command blocks shown above. You can supply Odoo connection details through environment variables to keep credentials out of your code. For a container-based setup, you can also run the server with Docker using the example below.
Security note: Use strong credentials for the Odoo user and avoid exposing credentials in logs or code. Consider restricting network access to the Odoo instance and enabling SSL on both the MCP server side and Odoo.
Troubleshooting tips: If you encounter authentication errors, double-check the Odoo URL, database name, and user credentials. If you see connection timeouts, verify network reachability and SSL settings. The server surfaces clear error messages for common Odoo API issues.
Tools exposed by the server include executing a method on an Odoo model, searching for employees by name, and searching for holidays within a date range. Use these to compose richer interactions with your AI assistant.
Execute a custom method on an Odoo model. Accepts model, method, optional args and kwargs; returns the method result and a success flag.
Search for employees by name with an optional limit and returns matching names and IDs.
Search holidays within a date range, with optional employee filtering, returning matches and status.