Setup Guide

Get Claude connected to your Odoo in under 5 minutes. No code required.

Requirements

Odoo instance — any version (Odoo.com SaaS, Odoo.sh, or self-hosted)
Your Odoo must be accessible over HTTPS from the public internet
Claude Pro, Team, or Enterprise account (for Connectors feature)
Administrator access to your Odoo to install the module

On-premise / firewall note: If your Odoo is behind a corporate VPN or firewall, Claude will not be able to reach it. Odoo.com SaaS and Odoo.sh instances work without any network configuration.

Installation

Log in to your Odoo as an administrator.
Go to the Apps menu and search for MCP Server for Odoo.
Click Install. The module registers a license with KSRO Labs (db UUID, base URL, company name only — no business data).
Go to Settings → MCP Server and enable the toggle.
The MCP endpoint is now live at https://your-odoo.example.com/mcp.

License grace period: The module works immediately for 72 hours after install. License activation may take up to 24 hours to complete. If you have not received activation confirmation after 24 hours, contact [email protected].

Connect Claude.ai (browser)

Open claude.ai and click your profile icon → Settings.
Go to Connectors → Add custom connector.
Enter your Odoo MCP URL:

https://your-odoo.example.com/mcp

Click Add. Claude redirects you to an OAuth login page on your Odoo.
Log in with the Odoo user account you want Claude to act as, then click Authorize.
Done. Claude now has access to all 34 MCP tools, limited by that user's Odoo permissions.

Connect Claude Desktop

Open Claude Desktop → Settings → Developer → Edit Config.
Add the following entry to your claude_desktop_config.json:

{
  "mcpServers": {
    "odoo": {
      "url": "https://your-odoo.example.com/mcp",
      "transport": "http"
    }
  }
}

Save the file and restart Claude Desktop.
A browser popup will open for OAuth authorization. Log in to your Odoo and click Authorize.
The Odoo tools will now appear in the Claude Desktop tool panel.

First prompts to try

Start with these to verify the connection is working:

List the models available in my Odoo
Show me the last 5 sale orders
How many customers do I have?
What are my top 3 products by quantity sold this month?
Show me all invoices with status "overdue"

Write operations

Create a new contact: John Smith at Acme Corp, email [email protected] Update the price of product "Laptop Pro" to 1499 Create a sale order for customer Acme Corp with 2 units of Laptop Pro

Troubleshooting

Problem	Fix
Cannot connect to server	Verify your Odoo is accessible over HTTPS from the public internet. Test by visiting https://your-odoo.example.com/mcp in a browser — you should see a JSON response.
Authorization failed / redirect error	Check that web.base.url in Odoo Settings → Technical → System Parameters exactly matches the URL you entered in Claude's connector setup, including the protocol and no trailing slash.
License inactive / expired	The module works for 72 hours after install, then requires license activation. Contact [email protected] with your Odoo URL if activation has not completed.
Tool not found / no tools available	Ensure the MCP Server is enabled: Odoo Settings → MCP Server → toggle On. If still missing, reinstall the module and re-authorize the connector.
Claude says it cannot access Odoo	Revoke the connector in Claude.ai and re-add it. Make sure you are logged into the correct Odoo user account when authorizing — the connector uses that user's session.
Write operations fail with access error	The Odoo user you authorized does not have write permission for that model. Either adjust the Odoo user's role, or switch to a user with the required access.

If your issue is not listed here, email [email protected] or use the support page.

Giving your team access (shared client)

By default each person runs through the OAuth flow independently — Claude registers its own client automatically and each user authorises with their own Odoo account. This is the recommended path for individuals.

If you manage a team and want to distribute a single pre-configured set of credentials, you can create a Shared OAuth Client from inside Odoo:

In Odoo go to MCP Server → OAuth Clients.
Click the Action menu → Create Shared Client.
Give it a name (e.g. “Team Claude Connector”), confirm the redirect URIs, then click Generate Credentials.
Copy the Client ID and Client Secret that appear — the secret is shown only once.
Share both values with your team members.

Each team member adds the connector in Claude like this:

URL: https://your-odoo.example.com/mcp
Advanced Settings → OAuth Client ID:     (paste Client ID)
Advanced Settings → OAuth Client Secret: (paste Client Secret)

They will still be redirected to your Odoo login page and must authorise with their own Odoo user account. The shared credentials identify the application — not the person — so each user's Claude session runs under their individual Odoo permissions.

Auto (leave fields empty) — best for individuals. No admin steps required.
Shared client — best for teams. One named application, central control, admin can revoke all access in one click from OAuth Clients list.