Installation

Prerequisites

• Python 3.11+
• uv (recommended) — or pip install fastmcp httpx
• An Odoo instance (v17, 18, or 19+)

Clone the repository

git clone https://github.com/oconsole/odoo-mcp-server.git

The server is a single file (odoo_mcp_server.py) with inline dependency metadata. No virtualenv needed — uv handles everything.

Claude Code

Add to your project's .mcp.json:

{
  "mcpServers": {
    "odoo": {
      "type": "stdio",
      "command": "uv",
      "args": ["run", "--python", "3.11", "--script", "/path/to/odoo_mcp_server.py"],
      "env": {
        "ODOO_URL": "https://your-instance.odoo.com",
        "ODOO_DB": "your-database",
        "ODOO_USER": "admin",
        "ODOO_PASSWORD": "your-password"
      }
    }
  }
}

Cursor

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "odoo": {
      "command": "uv",
      "args": ["run", "--python", "3.11", "--script", "/path/to/odoo_mcp_server.py"],
      "env": {
        "ODOO_URL": "https://your-instance.odoo.com",
        "ODOO_DB": "your-database",
        "ODOO_USER": "admin",
        "ODOO_PASSWORD": "your-password"
      }
    }
  }
}

Windsurf

Same format as Cursor — add to your Windsurf MCP configuration file.

Verify the connection

Once configured, ask your AI agent:

Show me the Odoo connection info

The agent will call odoo_connection_info and return your instance URL, database, version, and authenticated user.