Odoo and Claude Code

Connect Odoo to Claude Code with MCP

Claude Code, Anthropic's coding assistant that works in your terminal, can read your Odoo while you code: model structure, fields, real data. One command adds it, and authorization goes through OAuth. This guide is for Odoo developers and integrators, from version 16 to version 20.

Esteban ANTONIO-MOTA · Procedure verified on 10 November 2026

📌 Key takeaways

One command adds the server: claude mcp add --transport http aidoo https://mcp.aidoo.ai/mcp.
Then type /mcp in Claude Code to authenticate in the browser.
Use the user scope to have it in all your projects, or project to share the configuration in the repository (.mcp.json file, no secrets).
Read-only by default: you explore a database with no risk of changing it.

Why connect Claude Code to Odoo

When you develop for Odoo, a good share of your time goes into checking things: the exact name of a field, which module adds it, how many records are affected. Once connected to your database, Claude Code answers those questions itself.

Say you are writing a report on a customer's sales orders. Instead of turning on Odoo's developer mode to list the fields, you ask Claude Code: "Which sale.order fields relate to delivery in this database?" It reads the model structure, custom modules included, and writes the code with the right names.

Write a module with the real fields: types, relations and fields added by installed modules.
Check data without leaving the terminal: how many orders have a given status, which products have no category.
Prepare an import or a migration: spot empty fields, compare values, count duplicates.
Write an Odoo search domain and test it right away on real data.

What you need

Three prerequisites:

Claude Code installed and signed in to your account: see the Claude Code documentation;
an Aidoo account with an Odoo connection set up: see Connect your Odoo;
a browser on the same machine, for OAuth authorization.

Add Aidoo to Claude Code

Four commands, in the terminal and then in Claude Code.

1
Step 1. Add the server
In your terminal, from the project folder:
Terminal
```
claude mcp add --transport http aidoo https://mcp.aidoo.ai/mcp
```
2
Step 2. Choose the scope
Without an option, the server is only available in the current project, and only for you. Add --scope user to have it in all your projects, or --scope project to write it to the repository's .mcp.json file and share it with your team. This file contains no secrets: each developer authenticates with their own account.
Terminal
```
claude mcp add --transport http aidoo --scope user https://mcp.aidoo.ai/mcp
```
3
Step 3. Authenticate
Start Claude Code, type /mcp, choose aidoo and follow the sign-in flow in the browser: sign in to Aidoo, choose the workspace, set the connector's rights, authorize. Only read access is checked by default.
Claude Code
```
/mcp
```
4
Step 4. Check it works
The following command lists your MCP servers and their status. Then ask a first question, for example: "List the Odoo models whose name contains invoice".
Terminal
```
claude mcp list
```

Example requests

A few requests that save an Odoo developer time:

"Describe the res.partner model in this database, custom fields included."
"How many products have no category? Give me the first 10."
"Write the Odoo domain that selects quotations sent more than 15 days ago, then test it."
"Compare the breakdown of stock.picking statuses over the last three months."

More requests, sorted by department, are in the recipes by team.

Best practices

Claude Code easily chains dozens of calls. A few simple rules keep your database safe:

For development, connect an Aidoo workspace linked to a test database rather than to production whenever you can.
Stay read-only, and add write access only for a specific task.
Share the configuration with --scope project rather than passing credentials around: the .mcp.json file only contains the address.
For Cursor or Windsurf, which don't use OAuth, follow the local clients guide with an Aidoo API key.

Going further: build Odoo modules

Want to generate, test and deploy Odoo modules from Claude too? That is what Aidoo Modules does: the code is written for your Odoo version, tested in a sandbox, then pushed to your Git repository. A question about your project? Write to us.

Other guides

Frequently asked questions

Do I need an API key for Claude Code?

No. Claude Code handles OAuth: you authenticate with /mcp. The Aidoo API key is only for clients without OAuth, such as Cursor or Windsurf.

Can I see the models from my custom modules?

Yes, as soon as they are exposed in Aidoo. Introspection of your database detects the models and fields added by your modules.

Can I share the configuration with my team?

Yes, with --scope project: the server is written to the repository's .mcp.json file. Each developer then authenticates with their own Aidoo account.

Can Claude Code write to Odoo?

Only if you check write rights when you authorize access, and within the limits of your Odoo user's rights.

Which Odoo versions are supported?

Odoo 16, 17, 18, 19 and 20, Community or Enterprise, on Odoo Online, Odoo.sh or your own server.

Sources

Updated on 10 November 2026

Have an Odoo project, or want to put your ERP to work with AI?

Integrator or in-house tech team, let's talk about your Odoo development work and where AI fits into the way you work.

Let's talk See a demo