SSyncDev

Calderkit Odoo MCP Server

An Odoo module that serves a read-only MCP endpoint at /mcp, scoped to each user's own access rights.

Remote server

What is the Calderkit Odoo MCP Server?

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.

Seven read-only tools

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.

Who sees what

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.

Setting it up

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.

Limits worth knowing

  • Odoo Online is not supported, because it does not allow modules with Python code.
  • /mcp must resolve to the right database: one database per server, a dbfilter mapping, or on 19 and 20 an X-Odoo-Database header.
  • Web connectors that only sign in with OAuth, such as Claude.ai and ChatGPT, cannot use API keys. They require the paid Pro module ($89 per Odoo version), which also adds create and update tools with approval inside Odoo.

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.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
odoo_contextReturns the connected user, company, language, time zone and today's date.
odoo_list_modelsLists the models the assistant is allowed to use, with a short hint for each.
odoo_describe_modelDescribes a model's fields: type, label, relation and selection values.
odoo_searchSearches records with any Odoo domain, sorted and paged, and returns the total match count.
odoo_readReads records by ID.
odoo_countCounts the records that match a domain.
odoo_aggregateReturns grouped totals, such as revenue per customer per month, without reading every record.

How to install the Calderkit Odoo MCP Server

{
  "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.

Frequently asked questions

Not with the free module. It has no write or delete tools. Create and update tools, with approval inside Odoo, are part of the paid MCP Server Pro module.