Odoo Server (Remote)

Remote MCP server for Odoo ERP — exposes Odoo operations over Streamable HTTP with bearer token authentication.

Quick Start

cp .env.example .env
# Edit .env with your Odoo credentials and MCP_API_KEY

pip install -e .
python -m odoo_mcp_remote

Docker

cp .env.example .env
docker compose up --build

Client Configuration

Claude Desktop / Claude Code

If your client supports streamable-http natively:

{
  "mcpServers": {
    "odoo": {
      "type": "streamable-http",
      "url": "http://your-server:8000/mcp",
      "headers": {
        "Authorization": "Bearer your-secret-api-key-here"
      }
    }
  }
}

Using supergateway (stdio bridge)

If your client only supports stdio transport (e.g. some Claude Desktop versions), use supergateway to bridge the connection:

{
  "mcpServers": {
    "odoo": {
      "command": "npx",
      "args": [
        "-y",
        "supergateway",
        "--streamableHttp",
        "http://your-server:8000/mcp",
        "--header",
        "Authorization: Bearer your-secret-api-key-here"
      ]
    }
  }
}

Tools

Tool	Description
search_records	Search Odoo records with domain filters
get_record	Get records by ID
create_record	Create new records
update_record	Update existing records
delete_record	Delete records
list_models	List available Odoo models
get_model_fields	Get field definitions for a model