Setup Guide

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

Requirements

Odoo 19 instance (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 35 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.