| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Lines of code | 3528 |
| Technical Name |
em_odoo_mcp_server |
| License | LGPL-3 |
| Website | https://easymob.net |
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Lines of code | 3528 |
| Technical Name |
em_odoo_mcp_server |
| License | LGPL-3 |
| Website | https://easymob.net |
Odoo MCP Server
Claude, Cursor & ChatGPT Integration
Connect Claude Desktop, Cursor IDE, ChatGPT, Gemini and other AI agents directly to your Odoo ERP using the Model Context Protocol (MCP). Enable secure CRUD access, AI automation, intelligent ERP assistants and real-time business workflows for Odoo 19.
AI Assistants That Actually Understand Your Business
Modern AI agents are powerful, but disconnected from your ERP. This Odoo MCP Server creates a secure bridge between your business data and AI assistants, allowing Claude, Cursor, ChatGPT and other AI tools to safely search, analyze, create and update records directly inside Odoo using natural language.
Built For Production AI Deployments
Unlike basic API bridges, this module provides a full production-grade MCP Server implementation with enterprise security, audit logging, configurable permissions, rate limiting, multi-company support and secure MCP transport.
Secure Authentication
SHA-256 API keys, IP whitelisting and configurable access controls.
Audit Logging
Full request and response tracking for complete traceability.
Real-Time MCP
Streamable HTTP transport with Server-Sent Events support.
Multi-Company Ready
Enterprise-ready architecture compatible with large deployments.
Key Features of the Odoo AI MCP Server
Everything needed to build AI copilots, AI assistants and intelligent ERP workflows directly inside Odoo.
Intelligent ERP Search
Allow AI agents to search, analyze and understand Odoo data across CRM, Sales, Inventory, Accounting, HR and Helpdesk models in real time.
AI Workflow Automation
Create records, update pipelines, assign tickets, automate tasks and execute business workflows using natural language conversations.
Custom MCP Tools
Build custom AI workflows and server-side automations using secure sandboxed Python execution and configurable permissions.
Real-world MCP Server Use Cases
See what prompts you can give your AI once this MCP module is installed.
Ticket Triage
"Find all unassigned tickets created today, summarize them, and assign each to the appropriate technician based on the issue."
Meeting Follow-up
"Read the meeting notes I just took for Acme Corp and automatically create a new CRM Lead attached to their company profile."
Stock Assessment
"Do we have 'Acoustic Block Screens' in stock right now? If not, check our vendors and tell me the estimated lead time."
Invoice Chasing
"List all unpaid customer invoices over $500 that are past due by 30 days, and generate a draft reminder email for each."
Leave Management
"Look up the PTO balance for Jane Doe and check if she has any pending time-off requests for the month of December."
System debugging
"Analyze the structure of `sale.order` model and write a snippet to override the compute method for `amount_total`."
Odoo MCP Server Setup Guide
Five simple steps to connect any AI agent to your Odoo instance via Model Context Protocol.
Install Module
Install this module from the Odoo Apps menu, just like any other app.
Generate API Key
Go to Settings → MCP Server → API Keys. Click "New", provide a name, and copy the newly generated secret key immediately.
Configure Model Permissions
Go to MCP Server → Model Access and explicitly grant Read, Write, or Create permissions for the models the AI requires access to.
Connect your AI Client via SSE
The most reliable way to connect is via Server-Sent Events (SSE). In clients like Cursor or Windsurf, simply add a new SSE server with the following configuration:
{
"mcpServers": {
"odoo": {
"type": "sse",
"url": "https://your-odoo-url.com/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}
Initialize with the System Core Prompt
To maximize agent capabilities, prevent hallucinated field names, and give your AI advanced understanding of Odoo's ORM operations and business terminology mapping, we provide a pre-optimized system initialization template.
How to access & apply it:
- Navigate to MCP Server → Prompts → System Core Prompt inside your Odoo backend.
- Click inside the code block and press Ctrl+A then Ctrl+C to copy the entire formatted context block instantly.
- Paste these instructions directly into your AI client configuration (such as your Cursor project rules, Claude custom instructions, or agent base initialization prompt).
MCP FAQ & Troubleshooting
Connection Reset or Timeout Error
Ensure your Odoo instance allows Server-Sent Events (SSE). If you are behind a reverse proxy (like Nginx), make sure buffering is turned off for the `/mcp` routes (`proxy_buffering off;`).
AI Says "Model Access Denied"
This means the AI is trying to query a model (e.g., `sale.order`) that hasn't been allowed. Go to MCP Server → Model Access and add the model to the allowed list.
Authentication Failed (401 Unauthorized)
Check your client configuration block. Ensure the header `Authorization: Bearer <API_KEY>` is exactly correct, with no trailing spaces on the key.
Odoo MCP Protocol Integration (Model Context Protocol)
Designed for Odoo 19 • Implements MCP Spec 2024-11-05 • Open Source LGPL-3
Author & Support (Copy & Paste)
https://easymob.net
https://demo-odoo.easymob.net
https://support.easymob.net
contact@easymob.net
Please log in to comment on this module