Why connect Claude to Odoo?
Odoo holds critical business data — sales orders, invoices, CRM leads, inventory levels, purchase history. But extracting insight from that data typically requires: custom reports, SQL queries, or manual data exports.
When you connect Claude to Odoo, you can query all of this with natural language. "Show me the top 10 customers by revenue this quarter." "Which invoices are overdue by more than 30 days?" "Create a draft quote for Acme Corp based on last month's order."
The KSROlabs MCP Server for Odoo makes this possible — securely, with full Odoo permission enforcement and audit logging for every AI action.
What you need before you start
Odoo instance
Odoo 16.0, 17.0, or 18.0 — self-hosted or Odoo.sh. You need admin access to install modules and configure settings.
Claude account
Claude Desktop (macOS or Windows) or access to the Claude API via Anthropic. A Claude Pro or Team subscription is recommended for regular use.
MCP Server module
The KSROlabs MCP Server for Odoo, available on the Odoo App Store. Purchase and download the .zip for your Odoo version.
Admin permissions
Odoo administrator access to install modules and create API keys. Claude will inherit the permissions of the Odoo user the key is associated with.
Step-by-step setup guide
Follow these 6 steps to go from a fresh Odoo instance to a working Claude + Odoo integration.
Purchase and install MCP Server for Odoo
Buy the KSROlabs MCP Server from the Odoo App Store. Install it in your Odoo instance like any standard module — go to Apps, search "MCP Server", and click Install.
Enable the MCP endpoint in Odoo Settings
Navigate to Settings → Technical → MCP Server. Toggle the MCP Server to enabled. Grant the "MCP Server Administrator" group to any Odoo user who will manage API keys.
Create a scoped API key for Claude
In MCP Server settings, create a new API key named "Claude Desktop". Select which Odoo models this key can access (e.g., sale.order, res.partner, account.move). Copy the token — it is shown only once.
Configure rate limits and IP rules (optional)
For production security, configure rate limits per key (e.g., 60 requests/minute) and optionally restrict to your Claude Desktop IP address. Enable field allowlists for sensitive models.
Add the Odoo MCP Server to Claude Desktop
Open Claude Desktop → Settings → Developer → Edit Config. Add your Odoo MCP Server as a custom MCP server with your Odoo URL and Bearer token. Save and restart Claude Desktop.
Start querying Odoo with Claude
Open a new Claude conversation. Claude will automatically discover available Odoo tools. Start with natural language: "List all open sales orders over £10,000" or "Show me overdue invoices from last month."
What Claude can do once connected
Once configured, Claude has access to 8 MCP tools that cover every key Odoo operation:
list_modelsDiscover which Odoo models are available for your API key
describe_modelGet field metadata for planning queries and data structures
search_recordsSearch Odoo records with domain filters, limits, and sorting
get_recordFetch a specific Odoo record by ID
create_recordCreate new records in Odoo (if key allows write access)
update_recordUpdate existing Odoo records with validation
delete_recordDelete records (only if explicitly allowed by key scope)
initializeServer capabilities, version info, and health metrics
Security best practices
Connecting an AI agent to your ERP requires careful access control. Follow these practices:
Use a dedicated, least-privilege Odoo user for each API key — not your admin account.
Enable field allowlists on sensitive models (HR, Payroll, Accounting) to restrict which fields Claude can see.
Set per-key rate limits to prevent accidental mass operations from consuming Odoo server resources.
If possible, restrict API key access to your Claude Desktop machine's IP address.
Rotate API keys regularly using the zero-downtime token rotation feature — configure a 7-day grace period so Claude keeps working during rotation.
Review the MCP audit logs weekly. Every Claude action is logged with timestamp, model, and payload — use this for compliance and debugging.
Frequently asked questions
Does Claude AI work natively with Odoo?
Not natively — Odoo does not ship with MCP support. The KSROlabs MCP Server module adds MCP protocol support to Odoo, making it compatible with Claude Desktop, Claude API, and any other MCP-compatible AI client.
Do I need the Claude API or Claude Desktop to connect to Odoo?
Both work. Claude Desktop (the desktop app) supports MCP Servers directly in its settings panel. The Claude API also supports tool use via MCP, so you can build custom agents programmatically.
Is it safe to connect Claude to Odoo?
Yes — the KSROlabs MCP Server enforces Odoo's built-in access controls. Claude can only access the models and records that the API key's scope allows. Every action Claude takes is logged in Odoo's audit trail. IP restrictions and rate limits add additional layers of security.
Can Claude create and update records in Odoo, or only read them?
Both read and write operations are supported. The MCP Server exposes create_record and update_record tools. You control which models allow write access per API key — you can make Claude read-only for sensitive models and allow writes only for specific ones.
What if I use Claude API instead of Claude Desktop?
You can connect via the Claude API by implementing an MCP client in your code. The KSROlabs MCP Server follows the standard MCP protocol, so any MCP-compatible client library works. Contact us for code examples and setup guidance.