Setup & Installation

Follow these steps to get your Odoo MCP Server up and running.

Installation

1. Copy the odoo_mcp_server directory into your Odoo addons path.
2. Restart your Odoo server.
3. Login to Odoo as an Administrator.
4. Go to Apps, search for MCP Server, and click Install.

Quick Start

1. Create an API Key

Navigate to MCP Server → Security → API Keys and click New.

Important

The full API key is shown only once at creation time. Copy and store it securely in your AI agent configuration.

2. Test the Health Endpoint

Verify the server is running by calling the public health endpoint (replace your-odoo-domain.com with your actual address):

curl https://your-odoo-domain.com/mcp/health

Expected response:

{"status": "ok", "server": "Odoo MCP Server", "version": "19.0.1.2.0", "sessions": 0}

3. Connect an MCP Client

Point your MCP client (Claude, GPT, Cursor, etc.) at your server:

• Endpoint URL: https://your-odoo-domain.com/mcp
• Auth Header: Authorization: Bearer <your-api-key>

Pro Tip

If you are running Odoo locally for testing, you can use http://localhost:8069/mcp. For production, always use your full domain with HTTPS.

4. Test a Sample Tool Call

First, establish an SSE session:

curl -H "Authorization: Bearer YOUR_KEY" https://your-odoo-domain.com/mcp

This will return an endpoint event containing a sessionId. Copy that ID. In another terminal, perform a search:

curl -X POST "https://your-odoo-domain.com/mcp?sessionId=YOUR_SESSION_ID" \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "search_records",
      "arguments": {"model": "res.partner", "limit": 5}
    }
  }'