An Odoo module that serves a read-only MCP endpoint at /mcp, scoped to each user's own access rights.
Most Odoo integrations run beside the ERP. This one runs inside it. The Calderkit Odoo MCP server is an Odoo module that adds a Streamable HTTP endpoint at /mcp on your own instance, so there is no extra process, container or third-party relay to stand up.
Once it is installed, an assistant can ask questions like "which customers bought the most last quarter?" and answer them from your actual records. It works on Odoo 18, 19 and 20, Community or Enterprise, on Odoo.sh or a self-hosted server. It is free under LGPL-3.
The tool set is small and deliberately cannot change anything:
odoo_context reports who is signed in, the company, language, time zone and today's date, so relative dates resolve correctly.odoo_list_models and odoo_describe_model show which models are exposed and what fields they hold.odoo_search, odoo_read and odoo_count find, fetch and count records using normal Odoo domains, with sorting and paging.odoo_aggregate returns grouped totals, such as revenue per customer per month, without pulling every row.There is no write tool and no delete tool.
Requests run as the person who created the API key. Their access rights, record rules, companies and field groups all apply, so the assistant sees exactly what that user would see in the Odoo interface. Administrators pick the exposed models under MCP Server, Configuration, Models; contacts, products, sales, purchases, invoices, CRM, projects and inventory are offered by default when installed. Users, settings and technical models can never be exposed. Password, token, key and signature fields and binary files are never returned, nor usable in filters.
Every call is logged with user, tool, model, filters, record count, duration and any error.
Install the module from the Odoo Apps store or by copying calderkit_mcp into your addons path, then update the apps list and install "MCP Server". Admins get access straight away; other users need the MCP Server / User role. Each person then creates an API key under Preferences, Security. On Odoo 20 choose the scope "MCP (AI assistants only)", which limits the key to this endpoint.
/mcp must resolve to the right database: one database per server, a dbfilter mapping, or on 19 and 20 an X-Odoo-Database header.If you are comparing this with other business system integrations, the main trade-off is clear: the free Calderkit Odoo MCP server reads but never writes. Browse more integration servers if you need an assistant that edits records.
Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.
| Tool | What it does |
|---|---|
| odoo_context | Returns the connected user, company, language, time zone and today's date. |
| odoo_list_models | Lists the models the assistant is allowed to use, with a short hint for each. |
| odoo_describe_model | Describes a model's fields: type, label, relation and selection values. |
| odoo_search | Searches records with any Odoo domain, sorted and paged, and returns the total match count. |
| odoo_read | Reads records by ID. |
| odoo_count | Counts the records that match a domain. |
| odoo_aggregate | Returns grouped totals, such as revenue per customer per month, without reading every record. |
{
"mcpServers": {
"odoo": {
"type": "http",
"url": "https://your-odoo.example.com/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}Install the Odoo module first. Replace the URL with your Odoo address and YOUR_API_KEY with a key created under Preferences > Security.
Run an Actual Budget ledger from your AI agent, with phone approvals for every change on paired machines.
Drives DaVinci Resolve 21.1, free edition included, from Claude Code through a Lua bridge running inside the app.
Manage a Linux VPS, Postgres and Odoo databases and GitLab deploys over SSH, with previews, allowlists and an audit trail.
Scans a Windows screen into a numbered element table so an agent clicks and types by id instead of guessing pixels.
Lets an AI assistant upload files, images and text to Pixeldrain and download them back, with optional client-side encryption.
Ask an assistant for today's internet-wide cyber threat band, score, critical advisories and data-source health.