Core Features

Connect Your AI Assistant — Configuration Guide

Copy the configuration for your tool below. Replace https://your-odoo.com with your Odoo URL and YOUR_API_KEY with the key from MCP Server → API Keys.

1. Claude Desktop (Anthropic)

Edit claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json, Windows: %APPDATA%\Claude\claude_desktop_config.json):

{
  "mcpServers": {
    "odoo": {
      "command": "npx",
      "args": [
        "-y",
        "@anthropic-ai/mcp-remote",
        "https://your-odoo.com/mcp/sse"
      ]
    }
  }
}

Claude will open a browser for OAuth 2.0 + PKCE login. After approval, your session appears in the Odoo dashboard.

2. Cursor IDE

Open Cursor Settings → MCP, click Add new MCP server, and enter:

• Name: odoo
• Type: sse
• URL: https://your-odoo.com/mcp/sse

Cursor negotiates OAuth automatically. Or use Bearer token mode by adding Authorization: Bearer YOUR_API_KEY header.

3. Windsurf (Codeium)

Add to your Windsurf MCP configuration file:

{
  "mcpServers": {
    "odoo": {
      "serverUrl": "https://your-odoo.com/mcp/sse",
      "serverType": "sse"
    }
  }
}

4. Zed Editor

Add to your Zed settings.json:

{
  "assistant": {
    "version": "2",
    "default_model": {
      "provider": "anthropic",
      "model": "claude-3-5-sonnet-latest"
    },
    "always_allow_tool_actions": true
  },
  "context_servers": {
    "odoo": {
      "url": "https://your-odoo.com/mcp/sse",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

5. Cline (VS Code Extension)

Open the Cline panel, go to Settings → MCP Servers, and add:

{
  "mcpServers": {
    "odoo": {
      "command": "npx",
      "args": ["-y", "@anthropic-ai/mcp-remote", "https://your-odoo.com/mcp/sse"]
    }
  }
}

6. Roo Code (VS Code Extension)

In Roo Code settings, add an MCP server:

{
  "mcpServers": {
    "odoo": {
      "type": "sse",
      "url": "https://your-odoo.com/mcp/sse",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

7. Continue.dev (VS Code & JetBrains)

Edit ~/.continue/config.json:

{
  "server": {
    "name": "odoo",
    "url": "https://your-odoo.com/mcp/sse",
    "headers": {
      "Authorization": "Bearer YOUR_API_KEY"
    }
  }
}

8. GitHub Copilot Chat (VS Code)

Add to your VS Code settings.json under MCP servers:

{
  "github.copilot.chat.mcpServers": [
    {
      "name": "odoo",
      "url": "https://your-odoo.com/mcp/sse",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  ]
}

9. OpenAI Codex CLI

Export your MCP server config before running codex:

export MCP_SERVER_ODOO_URL="https://your-odoo.com/mcp/sse"
export MCP_SERVER_ODOO_TOKEN="YOUR_API_KEY"
codex --mcp-server odoo

10. Generic SSE with cURL

Test your connection from the terminal:

curl -N \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: text/event-stream" \
  https://your-odoo.com/mcp/sse

11. Streamable HTTP (2025 Spec)

For clients supporting the newer Streamable HTTP transport:

curl -X POST https://your-odoo.com/mcp/http \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"tools/list","id":1}'

12. Python SDK

Build your own MCP client in Python:

from mcp import ClientSession, StdioServerParameters
from mcp.client.sse import sse_client

async with sse_client("https://your-odoo.com/mcp/sse",
                       headers={"Authorization": "Bearer YOUR_API_KEY"}) as (read, write):
    async with ClientSession(read, write) as session:
        await session.initialize()
        tools = await session.list_tools()
        print(tools)

Resources Exposed to AI

AI can browse your schema and data like a living API:

Resource URI	Description
odoo://models	List all available models with names
odoo://model/{model_name}	Get field definitions and metadata for a model
odoo://record/{model}/{id}	Read a specific record by ID
odoo://search/{model}/{domain}	Search records with a JSON domain (limit 10)

Audit & Monitoring

Configuration Reference

Setting	Path	Default
Enable MCP Server	General Settings → MCP Server	Enabled
Enable SSE Transport	General Settings → MCP Server	Enabled
Enable Streamable HTTP	General Settings → MCP Server	Enabled
OAuth Client ID	General Settings → MCP Server	odoo-mcp-client
API Key / Client Secret	General Settings → MCP Server	—
Public URL / Issuer	General Settings → MCP Server	Auto-detect
Default Max Records	General Settings → MCP Server	1000
Session Timeout	General Settings → MCP Server	60 minutes
Log Retention	General Settings → MCP Server	30 days

System Requirements

• Odoo Version: 18.0 (Community & Enterprise)
• Python Version: 3.10+
• Required Python Packages: mcp, anyio
• Installation: Standard Odoo module install—no extra steps
• Database: Works with all supported Odoo databases (PostgreSQL)