How to Connect Claude AI to Odoo

• Odoo → Apps → search "Advanced MCP Server" → Install
• If not visible, click Update Apps List and refresh

The MCP Server menu won't appear until you assign the group. Go to Settings → Users & Companies → Users, open your user, and under the Other tab set the MCP Server access level to MCP Administrator. Save, then refresh the browser.

The server ships in a Disabled state and blocks every AI request until you flip it on.

• In the top-right of the Server Settings form, click the big red Disabled stat button — it turns green Enabled
• Once enabled, the Connect a New Tool button appears in the form header — you'll use it in Step 3

• Rate Limits — 60 req/min · 10,000 req/day (defaults)
• Token Settings — Access 1h · Refresh 30d (OAuth 2.1 defaults)
• Features — Dynamic Client Registration (required for claude.ai), Event Streaming, Report Generation
• Audit — Log retention 90d; Log Payloads OFF unless debugging

Click Connect a New Tool (the button that appeared in the header when you enabled the server). This launches the built-in Connect-a-Tool wizard:

• Wizard Step 1 — Pick auth type: API key (Bearer) for Claude Desktop / Code CLI, or Browser login (OAuth) for claude.ai
• Wizard Step 2 — Configure: name the Connection, pick the Odoo user Claude will act as, set the scope (Full · Read Only · Custom)
• Wizard Step 3 — Done: the wizard displays the MCP Endpoint URL, the plaintext API key (shown once — copy it now), and a ready-to-paste configuration snippet for your Claude client

Pick the Claude client you're using and follow just that tab.

{
  "mcpServers": {
    "odoo": {
      "url": "https://your-odoo-url/odoo/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

claude mcp add --transport http odoo https://your-odoo-url/odoo/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

Open your Claude client and try any of these:

• "What tools do you have available for Odoo?"
• "How many customers do we have in Odoo?"
• "List the 5 most recent sales orders."

Then confirm in Odoo → MCP Server → Audit Logs that the request landed. Each row shows the Connection name, tool called, timestamp, latency, and outcome.