Odoo MCP Server for Claude AI
Connect Odoo to Claude Desktop, Claude.ai and any MCP-compatible AI assistant — securely, in minutes.
A native Odoo module that exposes your data through the open Model Context Protocol. RAG-trained Claude reads, creates and updates records, builds live dashboards and scans documents — while OAuth 2.0, per-tool permissions and full logging keep every action under your control.
What is Odoo MCP Server?
Odoo MCP Server is a native integration module that turns your Odoo 18 database into a secure endpoint for AI assistants. It implements the open Model Context Protocol (MCP) so Claude Desktop, Claude.ai's custom connectors, or any other MCP-compatible client can talk to Odoo directly — reading records, creating sale orders, generating dashboards and processing documents on your behalf.
Under the hood it exposes two endpoints — /mcp/sse and /mcp/health — protected by your choice of OAuth 2.0, API Key or JWT authentication. Claude ships with a RAG-trained system prompt that already understands Odoo's data model, and you stay in control of exactly which models, fields and operations it can touch through a granular Tools & Permissions manager.
Beyond simple chat, the module adds real business value: dynamic dashboard generation for Sales, Inventory, Accounting and CRM; document scanning with OCR to create partners and orders from scanned files; multi-company access control; and comprehensive logging of every request so you can audit exactly what the AI did, when, and as which user.
Why teams connect Claude with this module
Give AI real access to your ERP — without giving up control
Security-first design
OAuth 2.0, API Key or JWT authentication, token expiration, revocation, IP whitelisting and per-company access rules — you decide what Claude can reach.
RAG-trained Claude
Ships with a system prompt pre-trained on Odoo's ERP structure, so Claude asks smart questions and follows your guidelines out of the box — fully editable.
Ask for a dashboard, get a dashboard
"Generate a sales dashboard for this month" produces a live, styled HTML dashboard with real revenue, orders and partner data — no report builder needed.
Documents in, records out
Scan an invoice, customer order or business card and let Claude extract the data and create the matching Odoo record — with OCR built in.
Multi-company ready
Restrict AI access to specific companies and let every Odoo security group and record rule keep applying exactly as before.
Nothing happens off the record
Every request, model, user, status code and execution time is logged with configurable retention — full auditability, always.
Everything You Need to Connect Odoo & AI
One settings screen, eight tabs, full control
MCP Server Endpoints
Standards-based /mcp/sse and /mcp/health endpoints so any MCP client — not just Claude — can connect.
OAuth 2.0 · API Key · JWT
Pick "Sign in with Odoo" for a one-click, auto-generated OAuth flow, or fall back to a simple API key or JWT token for server-to-server use.
Editable Claude AI System Prompt
A ready-made, RAG-trained prompt teaches Claude your data-integrity and confirmation guidelines — rewrite it anytime from the Claude AI tab.
Dynamic Dashboard Generation
Sales, Inventory, Accounting and CRM dashboards generated on request, with a configurable default period (Today / Week / Month / Quarter / Year).
Document Scanning & OCR
Turn scanned invoices, purchase orders and business cards into Odoo records automatically, with OCR toggled per your needs.
Tools & Permissions Manager
Every tool (Read Sales Orders, Create Customers, Read Invoices…) has its own permission type, required fields, read-only fields and domain filters.
Multi-Company Support
Restrict which companies an AI token can access, on top of Odoo's existing company and record-level security rules.
Full Token Lifecycle Management
Create, extend or instantly revoke tokens, set expiration windows, and restrict tokens by IP address — all from Settings.
Comprehensive Logging & Monitoring
Action, user, model, record, HTTP method, status code, execution time and IP — every MCP request, with auto-cleanup by retention period.
Role-Based Security Rules
AI tokens still respect Odoo user permissions and access rights — Claude can never do more than the connected user is allowed to.
Works With Claude Desktop & Claude.ai
Add Odoo as a custom connector in Claude in under a minute — no coding, just paste your connector URL and click Allow.
How It Works
From install to "Claude, generate my sales dashboard" in four steps
Install & choose auth
Install the module, then pick OAuth 2.0 (recommended), API Key or JWT in Settings → MCP Server.
Copy your connector URL
Grab the ready-made https://your-domain/mcp?db=your_database link from the settings screen.
Connect Claude Desktop
Settings → Connectors → Add custom connector, paste the link, then click Allow on the Odoo login screen.
Just chat
Ask Claude to search records, create leads, generate a dashboard or scan a document — it takes it from there.
See It In Action
From configuration to a real Claude conversation with your live Odoo data
⚙️ One Settings Screen, Full Control
🏠 General tab — activate the configuration, turn on Multi-Company Support, enable MCP logging and set log retention, all in one place.
🔐 Choose OAuth 2.0, API Key or JWT. OAuth credentials are auto-generated with a one-click Test Connection button.
🔌 Your ready-to-copy /mcp/sse and /mcp/health endpoint URLs, generated for your instance.
🛡️ Toggle read/write access, set token expiration in days, and restrict which companies the AI can see.
🧩 Every tool — Read Sales Orders, Create Customers, Read Invoices and more — with its own model, method and permission type.
🧠 The default system prompt already covers data accuracy, permissions and confirmation guidelines — rewrite it freely.
📊 Turn on dashboard generation and set the default reporting period Claude uses when none is specified.
🧾 Let Claude scan documents and turn on OCR to extract text from images and PDFs automatically.
✅ The /mcp/health endpoint confirms your server, version and database are healthy before you connect.
🔗 Connect Claude Desktop in Under a Minute
In Claude, open Settings from the account menu.
Go to Connectors → Add → Add custom connector.
The custom-connector dialog opens, ready for your Odoo details.
Paste the connector URL from your Odoo MCP Server settings into Remote MCP server URL and click Add.
Your Odoo connector appears in the list — click Connect and Claude does the rest.
Log in with your Odoo user credentials, review the request and click Allow.
Claude confirms "Connected to odoo" — optionally set each tool to allow, ask, or deny.
That's it — Claude can now use every tool from this module to interact with your Odoo instance.
✨ Real Results — Dashboards & CRM Automation
💬 A plain-English request is all it takes — no report configuration screens.
📊 Claude pulls live Odoo data and renders total revenue, order status and revenue-by-partner in seconds.
🔍 Claude can research businesses on the web and turn the results straight into Odoo CRM leads.
✅ Each lead is created as a real Odoo record — Claude reports back the exact record IDs.
📋 Back in Odoo, the AI-generated leads sit right alongside your existing pipeline — same model, same views, same workflow.
Who Is This For?
If your team already lives in Odoo, this puts Claude right next to it
Odoo Admins & IT Teams
Roll out AI access with granular permissions, token control and full logs — without opening a security hole.
Sales & CRM Teams
Generate leads, pull dashboards and check pipeline status by simply asking Claude, in seconds.
Operations & Finance
Check stock levels, unpaid invoices and accounting KPIs through natural conversation instead of menus.
Consultants & Agencies
Give each client database its own scoped OAuth credentials, tokens and audit trail.
Technical Information
Module Details
| Version | 18.0.1.0.0 |
| Odoo Version | 18.0 (Community & Enterprise) |
| Category | Integration |
| License | OPL-1 |
| Author | RAG Solutions |
| Website | rag-solutions.cloud |
| Endpoints | /mcp/sse · /mcp/health |
Dependencies & Compatibility
Depends on:
Highlights:
- OAuth 2.0, API Key and JWT authentication built in
- Standards-based Model Context Protocol (MCP) endpoints
- AI dashboards for Sales, Inventory, Accounting & CRM
- Document scanning with optional OCR
- Per-tool permissions, IP whitelisting & full audit logs
Frequently Asked Questions
What is the Model Context Protocol (MCP), and why does Odoo need it?
MCP is an open standard that lets AI assistants like Claude connect to external systems in a consistent, secure way. This module implements an MCP server inside Odoo, so any MCP-compatible AI client can discover and use your Odoo data and actions as structured "tools" instead of guesswork.
Is this an official Anthropic or Odoo product?
No. Odoo MCP Server is an independent module built by RAG Solutions that connects your own Odoo instance to Claude (or any other MCP-compatible AI assistant) using the open MCP standard — it is not published or endorsed by Anthropic or Odoo S.A.
Which authentication method should I use — OAuth, API Key or JWT?
OAuth 2.0 ("Sign in with Odoo") is recommended for Claude Desktop and Claude.ai connectors — it's the most user-friendly and secure. API Key suits simple server-to-server integrations, and JWT is ideal for stateless applications.
Does Claude get unrestricted access to my Odoo data?
No. Every tool is individually configured with a permission type (Read / Write / Admin), required and read-only fields, and optional domain filters. On top of that, Odoo's own users, groups and record rules still apply — the AI can never act beyond what the connected user is allowed to do.
Can I use it across multiple companies or databases?
Yes. Multi-company support lets you restrict AI access to specific companies, and each database you install the module on gets its own OAuth credentials, tokens and logs — perfect for agencies managing several client instances.
Is every action Claude takes logged?
Yes. Every MCP request is logged with the action, user, model and record touched, HTTP method, status code, execution time, request/response data and IP address — with automatic cleanup after your configured retention period.
Does it work on Odoo Community and Enterprise?
Yes — it's built for Odoo 18.0 and works on both Community and Enterprise editions.
Give Claude Secure Access to Your Odoo Data
Install Odoo MCP Server, connect Claude Desktop in under a minute, and start asking for dashboards, leads and reports in plain English — with OAuth security and full logging built in.
By RAG Solutions · Odoo MCP Server · Compatible with Odoo 18 Community & Enterprise · rag-solutions.cloud
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