Installation

Follow these simple steps to install the MCP Server module on your Odoo instance.

1. Copy the odoo_ai_mcp folder to your Odoo addons directory.
2. Restart your Odoo server service.
3. Activate Developer Mode in Odoo.
4. Go to Apps, click "Update Apps List", search for "MCP Server", and click Install.

Figure: Installing the module from Apps menu

Configuration

3. Configure Model Access (Crucial!)

By default, no models are exposed. You must explicitly allow access.

• Navigate to MCP Server > Configuration > Model Access.
• Create a new rule (e.g., for res.partner).
• Check permissions: Read, Create, Write, Delete as needed.

Figure: Enabling access for Contacts (res.partner)

4. Generate API Key

Navigate to MCP Server > Configuration > API Keys. Generate a new key and copy it immediately. You will need this for your AI client.

AI Integration

To use Odoo with Claude Desktop, you need to edit your configuration file.

Add the following configuration:

{
  "mcpServers": {
    "odoo": {
      "url": "http://your-odoo-url.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_GENERATED_API_KEY"
      }
    }
  }
}

Restart Claude Desktop. You can now ask Claude questions like:

"Find the contact email for Azure Interior and update their phone number to +1-555-0100"

Code Examples

You can also interact programmatically using Python.

import requests
import json

API_KEY = "YOUR_API_KEY"
URL = "http://localhost:8069/mcp"

def mcp_call(tool, args):
    headers = {"Authorization": f"Bearer {API_KEY}"}
    payload = {
        "jsonrpc": "2.0",
        "method": "tool/call",
        "params": {"name": tool, "arguments": args},
        "id": 1
    }
    return requests.post(URL, json=payload, headers=headers).json()

# READ Example
print(mcp_call("odoo.res.partner.read", {
    "domain": [["city", "=", "New York"]],
    "fields": ["name", "email"]
}))

# CREATE Example
print(mcp_call("odoo.res.partner.create", {
    "values": {"name": "New Client", "email": "client@example.com"}
}))