Introduction
Odoo AI MCP Server — securely connect any AI assistant to your Odoo instance using the Model Context Protocol
Odoo AI MCP Server
Connect AI assistants (Claude, ChatGPT, Cursor, VS Code, and more) directly to your Odoo 19 instance using the Model Context Protocol (MCP). The module exposes a curated set of Odoo tools — querying records, creating data, sending emails, generating reports, managing files — all enforced by Odoo’s native security layer.
Rendering diagram…
Key Features
| Feature | Description |
|---|---|
| 16 MCP Tools | Data queries, creates, writes, deletes, reports, chatter, email, files, dashboards, approvals |
| OAuth 2.1 + PKCE | Web clients (Claude.ai, ChatGPT) authenticate without API keys |
| API Key support | Desktop clients (Cursor, Claude Desktop, VS Code) use Bearer tokens |
| User-scoped ACL | AI always acts as the authorizing Odoo user — no privilege escalation |
| Model Access Rules | Granular per-model CRUD allowlist on top of Odoo native security |
| Delete Approvals | Permanent deletes are queued for human review via systray notifications |
| Audit Logging | Every tool call is recorded with request/response payloads |
| Rate Limiting | Per-user, per-minute sliding-window counter |
| MCP Apps | Interactive operator cards rendered inside AI chat clients |
Module Info
| Property | Value |
|---|---|
| Technical Name | odoo_ai_mcp_server |
| Version | 19.0.1.1.0 |
| Odoo Editions | Community & Enterprise 19.0 |
| Category | Productivity |
| Author | Atharva System |
| MCP Endpoint | POST /mcp |
| Protocol Version | 2024-11-05 |
| License | OPL-1 |
Quick Start
- Install the
odoo_ai_mcp_servermodule from your Odoo addons path. - Enable the gateway: Settings → MCP Server → Active AI Assistant Gateway.
- Whitelist the models your AI may access: MCP Server → Model Access Rules.
- Connect: open MCP Server → Connect and run the wizard for your client.
- Start issuing MCP tool calls from your AI assistant.
Navigation
- Installation & Setup — install, enable, configure groups
- Connect Wizard — generate API keys and OAuth config
- Supported Clients — all compatible AI clients
- Settings Reference — all config parameters
- Authentication — API keys and OAuth 2.1 flows
- Model Access Rules — CRUD allowlists per model
- MCP Tools Overview — all 16 tools at a glance
- Security & Approvals — layered security model
- Architecture — module structure and request flows