Step 1 - Install the Module in Odoo

After installing the module, the MCP server is available at /mcp/sse and /mcp/health.

Step 2 — Configure Access

There are two ways to configure access to the Odoo MCP Server. You can either use user credentials or generate a connection token.

Option 1 — Use User Credentials

Go to Settings → RAG Odoo MCP Server.
Enable "User Credentials" and enter the user's login and password.

Once configured, save the settings and test the connection.

Option 2 — Generate a Connection Token

Go to Settings → RAG Odoo MCP Server.
Enable "Require API Key" and click "Generate User / Admin Token" to create a token for Claude, Cursor, or any MCP-compatible client.

User Token: Read-only access (cannot create or edit records).
Admin Token: Full access (can create and edit records).

You can choose whether the generated token has read-only or read/write permissions.

Step 3 - Configure Claude Desktop

- Windows + R: open %APPDATA%\Claude\claude_desktop_config.json
- Paste and edit this block in the "mcpServers" section according to the connection option you choosed:

User credentials option

"odoo": {
  "command": "npx",
      "args": [
        "mcp-remote",
        "https://PATH_TO_YOUR_INSTANCE/mcp/sse?db=YOUR_DATABASE_NAME",
        "--transport",
        "sse-only",
        "--allow-http"
      ]
    },

Secure token option

"odoo": {
  "command": "npx",
  "args": [
    "mcp-remote",
    "https://PATH_TO_YOUR_INSTANCE/mcp/sse?db=YOUR_DATABASE_NAME",
    "--allow-http",
    "--transport",
    "sse-only",
    "--header",
    "Authorization:${MCP_ODOO_AUTH}"
  ],
  "env": {
    "MCP_ODOO_AUTH": "Bearer YOUR_GENERATED_TOKEN_KEY"
  }
}

- If you use Odoo.sh, you do not need to specify the database (?db=your_database_name).
- You can also watch the configuration tutorial video above.

Step 4 - Start Using Claude with Odoo

Usage examples:

"Generate a sales dashboard for the current year"
"Show me all customers from France"
"Find products with stock below 10 units"
"List today's sales orders over $1900"
"Search for unpaid invoices from last month"
"Create partners from the attached document"
"Create a sale order from the attached customer order"