MCP for Odoo · AI & Automation · Odoo 16.0+

MCP Server for Odoo

Connect AI agents to Odoo — safely, with governance. Expose one stable endpoint (POST /mcp) with scoped API keys, permission enforcement, validation, and audit logs. The definitive MCP integration for Odoo.

POST /mcpJSON-RPC 2.0API Keys + ScopesAudit LogsDistributed Rate Limiting4x Faster (Cached)
MCP Server for Odoo
MCP Server for Odoo — AI agent demo
0x

API throughput (cached)

0%

Faster with schema cache

0+

Requests/sec supported

0%

Typical cache hit ratio

Model Context Protocol — explained

The Model Context Protocol (MCP) is an open standard created by Anthropic that defines how AI agents, LLMs, and automation tools connect to external systems. It gives AI models a structured, governed interface to read data and take actions in real applications — like your Odoo ERP.

The KSROlabs MCP Server for Odoo implements this protocol inside Odoo, exposing your ERP as a secure, permission-aware endpoint for AI agents. No custom API development. No prompt injection risks. Just governed Odoo MCP integration that works out of the box.

Built-in security and governance

Every feature is designed to keep your Odoo production instance safe while giving AI agents the access they need.

Single endpoint

One stable entry point (POST /mcp) for tool discovery and tool execution. Keeps integrations consistent and easy to maintain across AI clients.

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 the payload — helpful for security reviews, compliance, and debugging every AI action.

Field & record guards

Add per-key domain filters and optional field allowlists for precise, least-privilege access. AI agents see only what you allow.

Rate limits & IP rules

Global and per-key rate limits with optional IP allow/deny lists reduce abuse risk and protect your Odoo production instance.

Payload safety

Configurable payload size limits and optional error redaction keep integrations safe and stable in production environments.

Enterprise security & performance

Built for high-scale production deployments with comprehensive security governance, enterprise-grade performance, and horizontal scalability across unlimited workers.

Distributed Rate Limiting

  • Redis-backed with in-memory fallback
  • Per-second & per-minute configurable
  • Per-key overrides for trusted clients
  • 200+ req/sec throughput

Zero-Downtime Token Rotation

  • Multiple active tokens per key
  • Configurable grace periods (7 days)
  • Auto expiration notifications
  • No service interruption during rotation

Schema Caching

  • 5-minute intelligent cache
  • 96% faster: 2ms vs 50ms
  • Auto-invalidates on schema changes
  • 4x throughput boost

Prometheus Monitoring

  • Prometheus metrics endpoint
  • Latency percentiles (p50, p95, p99)
  • Grafana integration ready
  • Cache hit ratio tracking

Enterprise Guarantee: Production-ready with 4x API throughput, 96% faster requests, zero-downtime token rotation, and multi-worker scalability. Tested and verified in real-world deployments.

Setup in 6 steps

Configure once, then integrate safely with any MCP-capable client. Get from installation to a working Odoo MCP integration in minutes.

1

Install the module

Install the KSROlabs MCP Server for Odoo from the Odoo App Store like any standard Odoo module — no external dependencies required.

2

Enable MCP Server in Settings

Navigate to Settings → MCP Server and enable the MCP endpoint. Grant the MCP Server Administrator group to trusted users.

3

Create a scoped API key

Create an API key in the MCP Server settings. Copy the token (shown once). Configure which Odoo models this key can access using the Key Model Access settings.

4

Set optional security rules

Optionally configure IP allow/deny rules, rate limits per key, field allowlists, and domain filters for precise least-privilege access.

5

Connect your AI agent

Point your MCP-compatible client (Claude, GPT, LangChain, etc.) at your Odoo MCP endpoint. Use the Bearer token for authentication.

6

Query and act on Odoo data

Your AI agent can now read, create, update, and delete Odoo records — all within the access boundaries you defined, with every action logged.

Supported MCP tools

Eight purpose-built tools cover every AI agent use case — from model discovery to full CRUD operations. All tools are rate-limited and cached for performance.

list_models

Discover allowed models for a key (cached)

describe_model

Fields and metadata for agent planning (cached)

search_records

Domain-based search with validation

get_record

Fetch by ID with field access control

create_record

Create with validation and audit logging

update_record

Update with Odoo security rules enforced

delete_record

Delete only if allowed by key scope

initialize

Server info, capabilities, and metrics

Batch support: JSON-RPC array payloads are supported for multi-call requests. All tools are rate-limited and schema results are cached for 5 minutes.

What's new in v2.0+

This release brings production-ready infrastructure improvements for enterprise deployments.

Distributed rate limiting via Redis with fallback
Schema caching — 96% faster model discovery
Zero-downtime token rotation with grace periods
Token versioning — multiple active tokens per key
Prometheus metrics endpoint for monitoring
Automatic token expiration with notifications
Multi-worker support — no shared state issues
Production tested at scale with real workloads

MCP vs REST API for Odoo AI integration

Why the Model Context Protocol is a better approach than custom REST APIs for connecting AI agents to Odoo.

FeatureMCP for OdooCustom REST API
Protocol standardOpen standard (Anthropic MCP spec)Varies per implementation
AI agent nativeYes — designed for LLMsNo — requires wrapper code
Tool discoveryAutomatic — agents discover available toolsManual — agents need documentation
Odoo permission inheritanceBuilt-in with KSROlabsMust be implemented manually
Audit trailAutomatic via Odoo chatterMust be added separately
Setup complexityInstall module, configure scopesBuild endpoints, auth, mapping

Odoo AI Consultancy Partner

We're not just a tool provider — we're your Odoo AI consultancy partner. We help organisations unlock the full potential of AI within their Odoo ecosystem, from MCP Server implementation to enterprise-scale AI orchestration.

MCP Strategy & Planning

Design your Odoo AI integration strategy. Identify high-impact AI use cases, scope implementation, and plan rollout across teams.

Implementation & Setup

End-to-end MCP Server deployment. Configuration, API key scoping, security hardening, and production readiness validation.

AI Agent Customization

Build and customize AI agents (Claude, ChatGPT) for your Odoo workflows — sales automation, CRM intelligence, finance processing, and more.

Security & Governance

Audit API key scopes, implement least-privilege access, enforce rate limiting, and establish compliance workflows for AI operations.

Ongoing Support & Optimization

Performance tuning, monitoring setup, token rotation management, and team training for sustained AI-driven productivity.

100% Free Setup Support

Installing the module is easy. Setting it up correctly for production AI usage is critical. We personally help you configure, secure, and deploy your MCP Server — at no extra cost.

What we help you with (FREE)

  • Complete MCP Server configuration
  • Secure API key creation with proper scopes
  • Model-level least-privilege setup
  • Rate limiting + token rotation configuration
  • Cloud Desktop deployment guidance
  • Connecting Claude, ChatGPT, and Gemini clients
  • Production best-practice review

Why contact us?

MCP is powerful — but misconfiguration can limit its capabilities. When implemented correctly, this module can:

  • Enable governed AI automation inside Odoo
  • Power secure AI copilots for Sales, CRM & Accounting
  • Unlock cloud-based AI orchestration workflows
  • Deliver enterprise-grade observability & control

Ready to connect AI agents to Odoo?

Install the MCP Server for Odoo or contact us for free setup support and expert guidance.

View the Module →Request Free Setup

MCP for Odoo — frequently asked questions

Common questions about the Odoo MCP Server, Model Context Protocol integration, and connecting AI agents to Odoo.

What is the Model Context Protocol (MCP)?

MCP is an open protocol created by Anthropic that standardises how AI agents and large language models (LLMs) connect to external data sources and tools. It provides a governed, structured interface so AI systems can securely read data and take actions in business applications like Odoo ERP.

Which AI models or agents does the Odoo MCP Server support?

Any MCP-compatible client works with the Odoo MCP Server, including Claude (Anthropic), OpenAI GPT models, and custom AI agents built on frameworks like LangChain, AutoGen, CrewAI, or the Claude Agent SDK. Any tool that speaks the MCP protocol can connect.

Is it safe to expose Odoo to an AI agent via MCP?

Yes. The KSROlabs MCP Server enforces Odoo's built-in access control lists (ACLs) and record rules. AI agents can only read or write data that their associated Odoo user account is authorised to access. Every action is logged in Odoo's audit trail.

Can the AI agent write to Odoo, or only read?

Both read and write operations are supported. You configure per-client permission scopes — for example, allowing reporting-only (read) access for one AI agent and full CRUD access for another. Write access can be disabled entirely for maximum safety.

How do I install the MCP Server for Odoo?

Install the module from the Odoo App Store like any standard Odoo module. After installation, navigate to Settings → MCP Server to configure client credentials, allowed models, and access scopes. No custom API development is required.

What is the difference between MCP and a REST API for Odoo?

A REST API exposes raw endpoints that require custom integration code. MCP provides a standardised protocol specifically designed for AI agent interaction — with built-in tool discovery, structured responses, and governed access. MCP lets AI agents understand what actions are available without custom code.

Can I connect Claude to Odoo using the MCP Server?

Yes. Claude by Anthropic natively supports MCP. Once the KSROlabs MCP Server module is installed in Odoo, you can point Claude Desktop, Claude Code, or the Claude API at your Odoo MCP endpoint to query sales orders, invoices, inventory, CRM data, and more.

Does the Odoo MCP Server work with Odoo Community Edition?

Yes. The MCP Server for Odoo works with both Odoo Community and Odoo Enterprise editions. All standard Odoo models are accessible, and the module respects the same permission system regardless of edition.

Which Odoo versions does the MCP Server support?

The MCP Server module is built and tested on Odoo 16.0 and above, including Odoo 17 and Odoo 18. Check the Odoo App Store listing for the latest version compatibility.

Can multiple AI agents connect to the same Odoo instance?

Yes. Each AI agent is configured as a separate MCP client with its own credentials and access scopes. You can run multiple agents simultaneously — for example, one for reporting and another for workflow automation — without any conflict.

What Odoo data can AI agents access through MCP?

AI agents can access any Odoo model you configure: sales orders, purchase orders, invoices, inventory, CRM leads, contacts, projects, timesheets, and custom models. You control exactly which models and fields each MCP client can see.

Is the MCP Server for Odoo suitable for production use?

Yes. The module is designed for production environments with governed access, audit logging, configurable rate limits, and Odoo permission inheritance. It is production-safe by design and used by businesses connecting AI agents to live Odoo instances.

More Odoo integrations from KSROlabs

Beyond MCP — analytics connectors for Power BI, Tableau, Google Sheets, BigQuery, plus Google Drive storage and Google Shopping integrations for Odoo.

Odoo Analytics →BigQuery Connector →All Modules →