Installation
Install and enable the Odoo AI MCP Server module in Odoo 19
Installation
Requirements
| Requirement | Details |
|---|---|
| Odoo Version | 19.0 (Community or Enterprise) |
| HTTPS | Recommended for production; required for OAuth 2.1 web clients |
| Odoo User | A user to authorise AI connections (must be in MCP Server User group) |
Core Dependencies
The module declares the following Odoo module dependencies in __manifest__.py. All are bundled with standard Odoo 19:
base · base_setup · mail · rpc · web · http_routing · bus · spreadsheet_dashboardNo third-party Python packages are required.
Install the Module
- Copy the
odoo_ai_mcp_serverfolder into your Odoo addons path (e.g./opt/odoo/extra-addons/). - Restart the Odoo service.
- Navigate to Apps in the Odoo top bar.
- Click Update Apps List.
- Search for Odoo AI MCP Server and click Install.
After installation a top-level MCP Server application appears in the main menu.
Enable the Gateway
[!IMPORTANT] The gateway must be enabled before any MCP client can connect. Requests to
/mcpreturn HTTP 503 when the gateway is off.
- Go to Settings → General Settings.
- Scroll to the MCP Server section.
- Toggle Active AI Assistant Gateway to enabled.
- Click Save.
[!NOTE] Screenshot — Settings → MCP Server block
Place a screenshot of the Settings page with the MCP Server section visible here. Suggested filename:
settings-enable-gateway.png
Optional settings to configure at this stage:
- Enable MCP Audit Logging — records every tool call (recommended)
- Enable MCP Rate Limiting — throttle requests per user per minute
- Enable OAuth 2.1 — required for Claude.ai and ChatGPT.com
Security Groups
Two security groups are created on install:
| Group | XML ID | Purpose |
|---|---|---|
| MCP Server User | group_ai_integration_user | Users whose Odoo session/credentials are used by AI clients. Required before creating API keys or OAuth connections. |
| MCP Server Administrator | group_ai_integration_admin | Full access to Settings, Model Access Rules, Activity Log, and Dashboard. base.group_system (Technical Admin) inherits this group automatically. |
To assign a group:
- Go to Settings → Users & Companies → Users.
- Open the user record.
- In the Access Rights tab, set the appropriate MCP Server group.
Configure Model Access
Before connecting AI clients, whitelist the Odoo models they may access:
- Go to MCP Server → Model Access Rules.
- Click Create (or use Batch Configure Models for multiple models at once).
- Select the model, enable the desired CRUD flags, and save.
See Model Access Rules for a full reference.
Verify the Installation
Run a quick smoke test with curl:
curl -s -X POST https://your-odoo.com/mcp \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_MCP_KEY" \
-d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","clientInfo":{"name":"test"},"capabilities":{}}}' \
| python3 -m json.toolA successful response contains "protocolVersion": "2024-11-05" and "serverInfo".