Skip to content
MCP server

Odoo MCP Connector

Query, report on, and optionally modify any Odoo ERP from Claude. Read-only by default.

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
0.1.0
Listing updated
5 days ago

About Odoo MCP Connector

Odoo MCP Connector is an open-source MCP server. It runs locally on your machine and is started by your AI client.

Install

Run in a terminal

claude mcp add odoo-mcp-connector --env ODOO_URL='<ODOO_URL>' --env ODOO_DB='<ODOO_DB>' --env ODOO_USERNAME='<ODOO_USERNAME>' --env ODOO_API_KEY='<ODOO_API_KEY>' -- npx -y odoo-mcp-connector

Add to claude_desktop_config.json

{
  "mcpServers": {
    "odoo-mcp-connector": {
      "command": "npx",
      "args": [
        "-y",
        "odoo-mcp-connector"
      ],
      "env": {
        "ODOO_URL": "<ODOO_URL>",
        "ODOO_DB": "<ODOO_DB>",
        "ODOO_USERNAME": "<ODOO_USERNAME>",
        "ODOO_API_KEY": "<ODOO_API_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "odoo-mcp-connector": {
      "command": "npx",
      "args": [
        "-y",
        "odoo-mcp-connector"
      ],
      "env": {
        "ODOO_URL": "<ODOO_URL>",
        "ODOO_DB": "<ODOO_DB>",
        "ODOO_USERNAME": "<ODOO_USERNAME>",
        "ODOO_API_KEY": "<ODOO_API_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "odoo-mcp-connector": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "odoo-mcp-connector"
      ],
      "env": {
        "ODOO_URL": "<ODOO_URL>",
        "ODOO_DB": "<ODOO_DB>",
        "ODOO_USERNAME": "<ODOO_USERNAME>",
        "ODOO_API_KEY": "<ODOO_API_KEY>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "odoo-mcp-connector": {
      "command": "npx",
      "args": [
        "-y",
        "odoo-mcp-connector"
      ],
      "env": {
        "ODOO_URL": "<ODOO_URL>",
        "ODOO_DB": "<ODOO_DB>",
        "ODOO_USERNAME": "<ODOO_USERNAME>",
        "ODOO_API_KEY": "<ODOO_API_KEY>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "odoo-mcp-connector": {
      "command": "npx",
      "args": [
        "-y",
        "odoo-mcp-connector"
      ],
      "env": {
        "ODOO_URL": "<ODOO_URL>",
        "ODOO_DB": "<ODOO_DB>",
        "ODOO_USERNAME": "<ODOO_USERNAME>",
        "ODOO_API_KEY": "<ODOO_API_KEY>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • ODOO_URLOdoo base URL, e.g. https://your-company.odoo.comRequired
  • ODOO_DBOdoo database nameRequired
  • ODOO_USERNAMEOdoo login (email)Required
  • ODOO_API_KEYOdoo API key (or password)Required
  • ODOO_ENABLE_WRITESSet to 'true' to allow create/update/delete. Default false (read-only).
  • ODOO_TIMEOUT_MSPer-request timeout in milliseconds (default 30000).

Pricing

Open source

Odoo MCP Connector FAQ

Is Odoo MCP Connector free?

Yes. Odoo MCP Connector is open source, so you can use and self-host it for free.

How do I add Odoo MCP Connector to Claude Code?

Run this command in your terminal: claude mcp add odoo-mcp-connector --env ODOO_URL='<ODOO_URL>' --env ODOO_DB='<ODOO_DB>' --env ODOO_USERNAME='<ODOO_USERNAME>' --env ODOO_API_KEY='<ODOO_API_KEY>' -- npx -y odoo-mcp-connector

Where this comes from

  • Description: from the official MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers