odoo — Claude Code MCP server: features and setup
Connect an AI agent to Odoo to inspect records, export data, and make changes. Read-only mode disables write operations when you want to browse an instance safely.
claude mcp add --transport http odoo https://mcp.odooconsole.com/mcpWhat odoo does
This MCP server gives an agent access to an Odoo instance. It can search records with filters and selected fields, count matches, export data, and create, update, or delete records. Other tools inspect models, fields, views, and window actions, or run model methods. The server selects JSON-RPC for Odoo 17-18 and the JSON-2 API for Odoo 19+.
Set the instance URL, database, and username to connect. Odoo 17-18 uses a password; Odoo 19+ uses an API key. Set ODOO_READONLY=true to disable create, update, delete, and method-execution tools. That setting matters on a production instance, since otherwise the agent has access to write operations. The local setup uses uv with Python 3.11; a hosted HTTP endpoint is also available for supported clients.
What it helps with
- find orders using domain filters
- count matching records without fetching them
- export product data for a spreadsheet
- inspect required fields and model views
- prevent record changes while browsing an instance
Example prompts for the agent
- List this month's sale orders and show their fields.
- Inspect required fields and the default sort order for
sale.order. - Export all products from Odoo to a spreadsheet.
How to install odoo
Platform CLI: remote server
claude mcp add --transport http odoo https://mcp.odooconsole.com/mcpPlatform CLI: remote server
codex mcp add odoo --url https://mcp.odooconsole.com/mcpConfig file
{
"mcpServers": {
"odoo": {
"url": "https://mcp.odooconsole.com/mcp"
}
}
}Config file
{
"servers": {
"odoo": {
"type": "http",
"url": "https://mcp.odooconsole.com/mcp"
}
}
}Platform CLI: remote server
gemini mcp add -t http odoo https://mcp.odooconsole.com/mcpStep 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 odoo
How do I install odoo in Claude Code?
Run claude mcp add --transport http odoo https://mcp.odooconsole.com/mcp.
What does odoo do?
It connects an AI agent to Odoo for record queries, exports, changes, model inspection, and method calls. Read-only mode disables write tools.
Which Odoo versions does it support?
It uses JSON-RPC with Odoo 17-18 and the JSON-2 API with Odoo 19+. The server picks the protocol automatically.
