Connect any MCP client to Odoo and manage your business using natural language. Zero configuration required.
Works with Claude Desktop, Claude Code, Claude Cowork, Codex CLI, and any MCP-compatible client
Connect AI assistants directly to your Odoo data
MCP is an open protocol created by Anthropic (makers of Claude AI) that standardizes how AI assistants connect to external data sources and tools. This module implements an MCP server inside Odoo, exposing your business data and operations to any MCP-compatible AI client through a simple, secure interface.
Use Claude Desktop on your laptop, Claude Code in your terminal, or Codex CLI in your IDE. One integration, all your tools.
Every user brings their own API key. They can only see what they're allowed to see in Odoo. All permissions are enforced.
More AI tools adopt MCP every month. Connect once, benefit forever - no rewiring when you change tools.
Skip the API docs, SDKs, and webhooks. Install the module, connect your AI client, and you're done.
Your team already has preferred AI assistants. Let them keep using them with your Odoo data.
Try different AI providers without rebuilding integrations. Your MCP server keeps working no matter which AI you choose.
Ask questions, and let AI do all the work - all in natural language
Connect your Odoo MCP server to Claude Cowork and let your team collaborate with AI on real business data
Add Odoo as an MCP server in Claude Cowork and your entire team can query accounting data, run financial reports, and analyze KPIs - all through natural conversation.
18 AI-powered accounting tools for CPAs: trial balance, tax reports, journal entries, reconciliation, payments, and period close.
llm_tool_account
44 AI-powered tools for MIS Builder: create KPIs, configure periods, compute reports, drill down, and analyze variances.
llm_tool_mis_builder
Install these modules alongside llm_mcp_server, then add Odoo as an MCP server in Claude Cowork. Your team can immediately ask questions like "What's our profit margin this quarter?" or "Show me the trial balance for January".
Your AI assistant understands natural language and handles complex operations instantly
Find any data across your entire Odoo database
"Show me all customers in California"
Add new customers, orders, products instantly
"Create a new lead for Acme Corp"
Modify existing records with simple instructions
"Update the status of order #789 to delivered"
Ask complex questions about your business data
"What's our total revenue this quarter?"
Sales, CRM, Inventory, Accounting, HR, Project Management, Manufacturing - if it's in Odoo, you can talk to it with AI.
Create custom AI tools in seconds with the @llm_tool decorator. Extend functionality however you need.
Because it's awesome - and makes work feel like magic
No more clicking through menus. Just ask what you need, get instant results.
Non-technical staff can access Odoo data without training. Just talk naturally.
Respects all Odoo permissions. Users only see data they're authorized to access.
Yes, you heard it right! The MCP server starts automatically when you install the module.
No extra MCP server to run, no configuration needed - it's all built into Odoo.
Search in Apps and click Install. That's it - the MCP server is now running inside Odoo.
Open My Profile (click your avatar, top-right), scroll to Account Security, and click "New MCP Key".
The wizard gives you ready-to-paste configurations for Claude Desktop, Claude Code, and Codex CLI. Just copy and paste!
Click your avatar in the top-right corner, then select My Profile (or Preferences).
Scroll down to the Account Security section where you manage your API keys.
Enter a description (e.g. "Claude Desktop") and confirm your password.
The wizard shows your API key and ready-to-paste configs for each AI client. Copy and paste!
Every user generates their own key from their profile. The AI client inherits that user's Odoo permissions - they can only see and do what that user is allowed to.
Your MCP server is now live and ready to connect
Works with Claude Desktop, Claude Code, Claude Cowork, Codex CLI, and any MCP-compatible client
AI workflows
AI-first IDE
Codeium IDE
With MCP extension
Command line
AI coding assistant
AI team workspace
Step 1: Install mcp-remote package
npm install -g mcp-remote
Step 2: Add to config file
~/.config/claude_desktop/claude_desktop_config.json (Linux/macOS)
or %APPDATA%/Claude/claude_desktop_config.json (Windows)
{
"mcpServers": {
"odoo": {
"type": "stdio",
"command": "npx",
"args": ["-y", "mcp-remote", "http://localhost:8069/mcp",
"--header", "Authorization: Bearer YOUR_API_KEY"],
"env": { "MCP_TRANSPORT": "streamable-http" }
}
}
}
Run this command:
claude mcp add-json odoo '{
"type": "stdio",
"command": "npx",
"args": ["-y", "mcp-remote",
"http://localhost:8069/mcp",
"--header",
"Authorization: Bearer YOUR_API_KEY"],
"env": {"MCP_TRANSPORT": "streamable-http"}
}'
Add to ~/.codex/config.toml:
experimental_use_rmcp_client = true [mcp_servers.odoo] url = "http://localhost:8069/mcp" http_headers.Authorization = "Bearer YOUR_API_KEY"
github.com/apexive/odoo-llm/blob/18.0/llm_mcp_server/README.md
100% open source. Extend with custom tools using our simple decorator pattern.
Just add @llm_tool to any Python method. That's it!
from odoo.addons.llm_tool.decorators import llm_tool
class SaleOrder(models.Model):
_inherit = "sale.order"
@llm_tool(read_only_hint=True)
def get_pending_orders(self, customer_id: int):
"""Get all pending orders"""
orders = self.search([
('partner_id', '=', customer_id),
('state', 'in', ['draft', 'sent'])
])
return [{'id': o.id, 'name': o.name}
for o in orders]
Auto-registered! Tool appears instantly on next Odoo restart.
Complete CRUD operations through conversational AI - no coding required for end users
Query any record
Add new data
Modify records
Explore structure
See examples in llm_tool_demo module
Built with security and compliance in mind from day one
Each user brings their own API key with their exact Odoo permissions. No shared credentials, no data leaks - every request runs in the user's security context.
Every AI request respects Odoo's access control lists and record rules. Users only see and modify data they're authorized to access.
Industry-standard bearer token authentication. API keys can be revoked instantly and have configurable expiration for enhanced security.
Built on the official Model Context Protocol (MCP) by Anthropic. Future-proof, vendor-neutral, and production-ready.
Seamlessly integrates with Apexive's complete AI toolkit for Odoo
Have persistent AI conversations directly in Odoo with full context and history
Create specialized AI assistants for specific roles like sales, support, or accounting
Turn PDFs, images, webpages, and documents into AI-searchable knowledge base
AI agents that remember past conversations and learn from your interactions
Generate marketing content, product descriptions, and images with AI
Extend AI capabilities with custom business logic in just a few lines of code
Everything you need to get started and succeed
Step-by-step guides, troubleshooting tips, and API reference included.
Full source code available on GitHub. Contribute, customize, or learn from the implementation.
GitHub Repository:
github.com/apexive/odoo-llm
View code, report issues, or join discussions