Odoo AI 
MCP Server
Securely connect AI assistants and clients (like Claude Desktop or Cursor) to your Odoo instance using the standardized Model Context Protocol (MCP). Let AI act safely with precise user-scoped permissions, audit trails, and deletion control.
Why Odoo MCP Server Matters
Modern AI coding environments and assistants require access to business context to be truly effective. Standard APIs require complex integrations and custom scripts. The Odoo MCP Server exposes Odoo tools, models, and actions using Anthropic's open-source Model Context Protocol (MCP). It bridges the gap between advanced LLMs and your Odoo database, enabling assistants to search records, query fields, post chat messages, and export reports securely without compromising on safety or control.
Odoo AI MCP Server Architecture
Expose Odoo business tools, data models, and workflow actions directly to Model Context Protocol (MCP) compatible AI clients. This standardized bridge enables AI assistants like Claude Desktop, Cursor, and ChatGPT to safely interact with your Odoo ERP data using precise access permissions and approval controls.
Key 
Highlights
Connection Wizard
A quick step-by-step setup interface generating keys and configuring secure OAuth 2.0 routes for AI agents and clients to establish instant connections.
User-Scoped Permissions
AI interactions respect the active Odoo user's security rules, record rules, and access control lists. The AI cannot see or modify data the user cannot access.
Model-Level ACLs
Explicitly whitelist which database models (such as sales, purchases, or partners) the MCP server can expose to the AI, specifying Read, Write, Create, or Delete limits.
Delete Approvals
Prevent accidental data loss. Any request by the AI to delete records triggers a native Odoo systray notification requesting manual administrator review.
Activity & Audit Logs
Keep a close eye on AI operations. The server maintains a comprehensive, searchable history of every API request, payload, execution time, and response size.
Curated Chatter & Tools
Let the AI request PDF reports, retrieve status metadata, transfer files safely, send emails, or write notes directly to document chatters to coordinate on workflows.
How It Works
Connect Your Client
Generate authentication credentials using Odoo's built-in MCP Connection Wizard, and paste the server configuration details into Claude, Cursor, or your AI client.
Whitelist Models
Choose exactly which Odoo models the AI can access. Configure granular CRUD (Create, Read, Update, Delete) permissions on a model-by-model basis.
AI Execution & Approvals
Your AI client issues tool commands to inspect or edit records. System monitors request rates, records logs, and requests admin approvals for sensitive actions.
Exposed AI Tools
Easily demonstrate and record videos for each of the core tools. Use these example prompts inside Claude Desktop, Cursor, or any MCP client:
Executive Sales & Revenue Intelligence
Perform complex sales analysis, identify top-performing product segments, calculate MoM growth, and extract high-value customer details dynamically.
Customer Relationship & Chatter Automation
Record client updates, log internal notes directly to quotation logs, and programmatically schedule high-priority tasks and reminders for sales managers.
Professional Email & Communication Dispatch
Compose personalized follow-up emails, fetch client templates dynamically, and distribute documents with accurate terms and client information.
Automated PDF Document & Report Generation
Compile PDF statements, render official customer invoices, and aggregate accounting ledgers dynamically for instant download.
Interactive Spreadsheet & AI Analytics Dashboards
Instruct the AI to build dynamic multi-dimensional spreadsheet models, layout margins by representative, and generate regional revenue pivot views.
Enterprise Governance & Admin Approvals
Enforce strict data-protection logic and intercept delete actions, forwarding sensitive commands to Odoo systray notification panels for manual review.
Supported AI Clients
Seamlessly connect your Odoo instance using the Model Context Protocol to any compatible AI assistant or development environment.
Claude.ai (Web)
ChatGPT
Claude Desktop
Cursor IDE
VS Code
Opencode
Antigravity
OpenAI Codex
Windsurf
Cline
Grok
Many More
Interface Showcase
A fully integrated administrative suite inside Odoo to configure endpoints, check access permissions, and track active sessions.
MCP Connect Wizard
Easily configure API credentials and generate the exact JSON configurations required for your desktop AI integrations.
Model Access Control List
Explicitly map database tables and assign fine-grained read/write/create/delete access directly to the server profile.
Systray Deletion Approvals
Receive live notification badges in your utility panel whenever the AI requests a record deletion, enabling instant accept/reject overrides.
Rate Limiting Rules
Guard resources and server performance by setting execution limit thresholds and time frames for active connections.
Detailed Request Logs
Track all inputs, target endpoints, timestamps, durations, and outputs associated with active AI interactions.
OAuth 2.1 Authentication
Leverage standard modern authorization protocols to verify connections safely and log actions to specific users.
Technical Architecture
Model Context Protocol Standard
Adheres strictly to the official open standard from Anthropic. Ensures native integration with compatible IDEs and desktop clients.
Security & Encryption
Protects endpoints with authentication keys and HTTPS protocols. Restricts data access strictly to Odoo's access rights structures.
Low-Latency JSON-RPC
Leverages optimized JSON-RPC messaging layers to return data fast, keeping your AI interactions quick and responsive.
Frequently Asked Questions
Which AI clients are compatible?
Does it work with Odoo Community Edition?
Is my data secure?
Can I use it with a local Odoo instance?
What happens if the AI client requests a record deletion?
How do I update the module after installation?
You may also like
Atharva System
Providing high-quality Odoo modules to streamline your business workflows.
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
Discuss (mail)
|
| Lines of code | 10296 |
| Technical Name |
odoo_ai_mcp_server |
| License | OPL-1 |
| Website | https://www.atharvasystem.com/odoo-development |
Odoo Proprietary License v1.0 This software and associated files (the "Software") may only be used (executed, modified, executed after modifications) if you have purchased a valid license from the authors, typically via Odoo Apps, or if you have received a written agreement from the authors of the Software (see the COPYRIGHT file). You may develop Odoo modules that use the Software as a library (typically by depending on it, importing it and using its resources), but without copying any source code or material from the Software. You may distribute those modules under the license of your choice, provided that this license is compatible with the terms of the Odoo Proprietary License (For example: LGPL, MIT, or proprietary licenses similar to this one). It is forbidden to publish, distribute, sublicense, or sell copies of the Software or modified copies of the Software. The above copyright notice and this permission notice must be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
Please log in to comment on this module