| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Lines of code | 3528 |
| Technical Name |
em_odoo_mcp_server |
| License | LGPL-3 |
| Website | http://easymob.net |
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Lines of code | 3528 |
| Technical Name |
em_odoo_mcp_server |
| License | LGPL-3 |
| Website | http://easymob.net |
Odoo MCP Server
Connect your Odoo ERP directly to any AI Agent supporting the open Model Context Protocol. Empower your AI with real-time business context.
How it Works — A Simple Overview
Your AI assistant is incredibly smart, but it doesn't know what's happening inside your business. This module creates a secure, universal bridge so any AI can search, read, create, and update records inside Odoo — just by chatting.
Works seamlessly with your favorite tools
Key Features
Everything you need to turn Odoo into an AI-powered super system.
Intelligent Search
AI can search, read, and analyze data across any Odoo model in real-time, fetching only exactly what it needs.
Automated Actions
Create leads, update tickets, or archive records effortlessly via conversation. Safe, transactional, and audited.
Custom Code Execution
Allow the AI to write and execute highly specific Python scripts securely within your Odoo environment.
Real-world Use Cases
See what prompts you can give your AI once this 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`."
Security Architecture
Your ERP data is completely protected. The MCP Server acts as an authenticated bridge but never bypasses your Odoo security rules.
1. Explicit Model Access
AI agents can only access the models you explicitly grant them permission for. No stealth data mining.
2. API Key Authentication
Connect external tools securely using unique, revocable API Keys generated per-agent or per-organization.
3. Audit Logging
Every query and action executed by the AI is tied to the internal user associated with the API key, ensuring full traceability.
Setup Guide
Five simple steps to connect any AI agent to your Odoo instance.
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
Paste the MCP endpoint and your API key into your client's (Claude, Cursor) settings file. Here is an example config:
{
"mcpServers": {
"odoo": {
"command": "curl",
"args": [
"-N", "-s", "-X", "GET",
"-H", "Authorization: Bearer YOUR_API_KEY",
"https://your-odoo-url.com/mcp"
]
}
}
}
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).
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
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