mcp-odoo — Claude Code MCP server: what it does, how to install
Connects Odoo to an AI agent over MCP for data access, diagnostics, schema discovery, and gated write operations.
claude mcp add mcp-odoo -e ODOO_URL=<ODOO_URL> -e ODOO_DB=<ODOO_DB> -e ODOO_USERNAME=<ODOO_USERNAME> -e ODOO_PASSWORD=<ODOO_PASSWORD> -- uvx odoo-mcpWhat mcp-odoo does
mcp-odoo turns an Odoo 16+ database into an MCP server for Claude Code and other supported clients. It uses XML-RPC with Odoo 16–18 and External JSON-2 with Odoo 19+, covering record and attachment reads, schema inspection, call diagnostics, and addon upgrade checks.
The local server includes 41 MCP tools and 11 prompts for business workflows such as data-quality checks and month-end close. It can work with several named Odoo instances, search indexed knowledge locally, and run long read operations as background tasks.
Set ODOO_URL, ODOO_DB, ODOO_USERNAME, and ODOO_PASSWORD before connecting it. Writes go through environment gates and approval tokens, so the server cannot reach Odoo until these credentials are configured.
What it helps with
- read Odoo records and attachments
- inspect schemas and access rules
- query several named Odoo instances
- scan addons for upgrade risks
- route writes through approval
Example prompts for the agent
- Show me customers from Spain with unpaid invoices in Odoo.
- Audit the
custom_billingaddon for upgrade risks before moving to Odoo 19.
How to install mcp-odoo
Platform CLI
claude mcp add mcp-odoo -e ODOO_URL=<ODOO_URL> -e ODOO_DB=<ODOO_DB> -e ODOO_USERNAME=<ODOO_USERNAME> -e ODOO_PASSWORD=<ODOO_PASSWORD> -- uvx odoo-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from odoo-mcp <command>
Platform CLI
codex mcp add mcp-odoo --env ODOO_URL=<ODOO_URL> --env ODOO_DB=<ODOO_DB> --env ODOO_USERNAME=<ODOO_USERNAME> --env ODOO_PASSWORD=<ODOO_PASSWORD> -- uvx odoo-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from odoo-mcp <command>
Config file
{
"mcpServers": {
"mcp-odoo": {
"command": "uvx",
"args": [
"odoo-mcp"
],
"env": {
"ODOO_URL": "<ODOO_URL>",
"ODOO_DB": "<ODOO_DB>",
"ODOO_USERNAME": "<ODOO_USERNAME>",
"ODOO_PASSWORD": "<ODOO_PASSWORD>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from odoo-mcp <command>
Config file
{
"servers": {
"mcp-odoo": {
"type": "stdio",
"command": "uvx",
"args": [
"odoo-mcp"
],
"env": {
"ODOO_URL": "<ODOO_URL>",
"ODOO_DB": "<ODOO_DB>",
"ODOO_USERNAME": "<ODOO_USERNAME>",
"ODOO_PASSWORD": "<ODOO_PASSWORD>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from odoo-mcp <command>
Platform CLI
gemini mcp add -e ODOO_URL=<ODOO_URL> -e ODOO_DB=<ODOO_DB> -e ODOO_USERNAME=<ODOO_USERNAME> -e ODOO_PASSWORD=<ODOO_PASSWORD> mcp-odoo uvx odoo-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from odoo-mcp <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about mcp-odoo
How do I install mcp-odoo in Claude Code?
Run `claude mcp add mcp-odoo -e ODOO_URL=<ODOO_URL> -e ODOO_DB=<ODOO_DB> -e ODOO_USERNAME=<ODOO_USERNAME> -e ODOO_PASSWORD=<ODOO_PASSWORD> -- uvx odoo-mcp`. This adds the local MCP server with your Odoo credentials.
What does mcp-odoo do?
It connects Odoo to an MCP client and provides tools for reading data, inspecting schemas, diagnosing calls, and checking addons. Write operations pass through a gated approval flow.
Which Odoo versions does mcp-odoo support?
It supports Odoo 16 and newer. Odoo 16–18 use XML-RPC, while Odoo 19 and newer use External JSON-2.
