| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Lines of code | 760 |
| Technical Name |
mcp_server_odoo |
| License | LGPL-3 |
| Website | https://ksrolabs.com |
| Versions | 16.0 17.0 18.0 19.0 |
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Lines of code | 760 |
| Technical Name |
mcp_server_odoo |
| License | LGPL-3 |
| Website | https://ksrolabs.com |
| Versions | 16.0 17.0 18.0 19.0 |
Connect AI agents to Odoo - safely, with governance Connect AI agents to Odoo - safely
Give MCP-capable clients a controlled way to call Odoo actions as auditable tools - without weakening Odoo security.
Expose one stable endpoint (/mcp) with scoped API keys, permission enforcement, validation, and audit logs. Perfect for connecting assistants and automation flows to Sales, CRM, Accounting, Inventory, and custom models - with least privilege.
Connect Claude, Gemini, and ChatGPT-style agents to Odoo
This module exposes your Odoo as an MCP server. Any MCP-capable client can discover tools and make structured calls to read and write Odoo data through approved scopes and Odoo security rules.
How it works
- Install the module and enable MCP Server in Settings.
- Create an API key and assign model scopes (least privilege).
- Configure your MCP client with the /mcp endpoint + Bearer token.
- The client discovers tools and calls them in a predictable JSON-RPC format.
- Every request is enforced by Odoo permissions and logged for auditing.
Real-world examples
Use natural language to drive governed operations:
- Sales: "List open quotations for ACME and summarize next steps."
- CRM: "Create a lead, assign owner, and set a follow-up activity."
- Support: "Fetch customer history and draft a reply using last orders."
- Finance: "Show overdue invoices for this week and prepare reminders for review."
Highlighted features
Single endpoint
One stable entry point (POST /mcp) for tool discovery and tool execution. Keeps integrations consistent and easy to maintain.
Scoped API keys
Create keys per integration and restrict by model access. Rotate keys safely without breaking your Odoo permission model.
Audit-ready logs
Track which key called what, when, and (optionally) the payload - helpful for security reviews, compliance, and debugging.
Setup & usage
Configure once, then integrate safely with any MCP-capable client.
Setup in 5 steps
- Install the module.
- Enable Enable MCP Server in Settings.
- Grant the MCP Server Administrator group to trusted users.
- Create an API key and copy the token (shown once).
- Grant model access in Key Model Access (least privilege).
Example MCP request
Supported tools
- list_models - discover allowed models for a key
- describe_model - fields and metadata
- search_records - domain-based search
- get_record - fetch by id
- create_record - create with validation
- update_record - update with Odoo rules
- delete_record - delete only if allowed
Screenshots
Each screenshot highlights how governance, access control, and key scopes are managed.
1) Admin-controlled access
Restrict configuration to authorized users via standard Odoo groups.
2) Dedicated MCP settings
Enable the server, manage keys, scopes, and audit logs from Settings.
3) API key lifecycle
Tokens are shown once and never stored in plaintext for safer onboarding.
4) Granular scopes
Scope keys to the minimum required models and rotate keys regularly.
FAQ
Q: Does this bypass Odoo security?
A: No. Odoo ACLs, record rules, and groups still apply. Scopes only reduce what a key can access - they do not elevate permissions.
Q: Can I connect ChatGPT, Claude, or Gemini?
A: You can connect any MCP-capable client/agent to your Odoo instance by pointing it to the /mcp endpoint and providing the API key token.
Q: Is this module AI inside Odoo?
A: No. This is a secure integration gateway (MCP server). AI runs externally and calls approved tools through Odoo governance.
About KSROLABS
KSROLABS builds modern analytics and integration tooling for Odoo-powered businesses - removing complexity and making data accessible, clear, and actionable.
We focus on performance, reliability, and clarity - from enterprise-grade connectors to workflow automation.
Odoo to BI consulting, implementation support, and dashboard building services.
Email: ksrolabs.info@gmail.com
Website: https://ksrolabs.com
Please log in to comment on this module