1. Overview

The MCP Server for Odoo module exposes selected Odoo data to AI assistants through secure MCP-style JSON-RPC tools and HTTP endpoints.

It helps administrators:

• Connect AI assistants to Odoo through a controlled gateway.
• Enable only approved Odoo models.
• Restrict fields, operations, and result limits.
• Generate API keys for external AI clients.
• Keep Odoo user ACLs active.
• Review audit logs, sessions, request payloads, and errors.
• Monitor usage from an Odoo dashboard.

The module is designed for Odoo teams that want AI access to operational data without exposing the full database.

2. Compatible AI Clients

The module can be used by AI clients that support remote MCP servers, HTTP tools, JSON-RPC tools, custom headers, or API key query parameters.

Common compatible targets include:

• ChatGPT custom apps or connectors.
• Claude Desktop or Claude-compatible MCP clients.
• Gemini CLI with MCP server configuration.
• Cursor, Windsurf, and other IDE AI tools with MCP support.
• OpenAI-compatible or Anthropic-compatible local agent frameworks.
• Custom internal AI agents that can call HTTP JSON-RPC tools.

Compatibility depends on the AI client feature set. Some web chat interfaces do not allow custom MCP servers directly, while their CLI, desktop, IDE, or developer editions may support MCP configuration.

Recommended connection endpoint:

https://your-odoo-domain.com/sm_mcp/mcp

Supported authentication methods:

• X-API-Key: TOKEN_HERE header.
• Authorization: Bearer TOKEN_HERE header.
• ?api_key=TOKEN_HERE query parameter for clients that cannot send custom headers.

3. What the Module Adds

4. Installation

1. Copy the sm_mcp_server folder into an Odoo addons path.
2. Restart Odoo.
3. Update Apps List.
4. Install MCP Server.

Command-line example:

python3 ~/odoo/odoo-18/odoo-server \
   -c ~/odoo/conf/odoo.conf \
   -d your_database \
   -i sm_mcp_server \
   --stop-after-init \
   --no-http

5. Initial Setup

6. ChatGPT Connection

For ChatGPT custom apps or connectors, use the MCP JSON-RPC endpoint.

Recommended server URL when the UI does not support custom headers:

https://your-odoo-domain.com/sm_mcp/mcp?api_key=TOKEN_HERE

Set authentication to No Auth if the token is included in the URL.

If the ChatGPT connector supports custom headers, use:

{
  "url": "https://your-odoo-domain.com/sm_mcp/mcp",
  "headers": {
    "X-API-Key": "TOKEN_HERE"
  }
}

Do not use /sm_mcp/sse unless the ChatGPT UI explicitly asks for an SSE URL.

Test prompts:

Use Odoo MCP. Count res.partner records.

Use Odoo MCP. Search five customers and show name and email.

7. Claude Connection

Claude Desktop and Claude-compatible MCP clients can connect when they support a remote HTTP/SSE MCP server or a bridge command.

Use this endpoint when remote HTTP MCP is supported:

https://your-odoo-domain.com/sm_mcp/mcp

Use this header:

X-API-Key: TOKEN_HERE

For clients that only support SSE URL configuration, use:

https://your-odoo-domain.com/sm_mcp/sse?api_key=TOKEN_HERE

If a Claude client only supports local stdio MCP servers, use a small local proxy or bridge that forwards MCP JSON-RPC calls to the Odoo /sm_mcp/mcp endpoint.

8. Gemini Connection

Gemini web chat may not expose custom MCP server configuration. Use Gemini CLI or a Gemini-capable agent environment that supports MCP.

Gemini CLI example:

gemini mcp add --transport http sm-odoo-mcp \
   "https://your-odoo-domain.com/sm_mcp/mcp" \
   --header "Authorization: Bearer TOKEN_HERE"

Check configured MCP servers:

gemini mcp list

Inside Gemini CLI, inspect MCP tools:

/mcp
/mcp desc
/mcp schema

Test prompt:

Use Odoo MCP. Count res.partner records.

9. IDE AI Clients

For Cursor, Windsurf, and other IDE AI tools with MCP support, configure a remote MCP server if the client supports HTTP/SSE transport.

Generic configuration values:

Name: Odoo MCP
URL: https://your-odoo-domain.com/sm_mcp/mcp
Header: X-API-Key: TOKEN_HERE

If the IDE only supports local stdio MCP servers, use an MCP proxy that forwards local tool calls to the Odoo HTTP endpoint.

10. Manual API Tests

Set reusable variables:

export BASE_URL="https://your-odoo-domain.com"
export MCP_TOKEN="TOKEN_HERE"

Health check:

curl -s "$BASE_URL/sm_mcp/health"

Validate token:

curl -s -X POST "$BASE_URL/sm_mcp/auth/validate" \
   -H "Content-Type: application/json" \
   -H "X-API-Key: $MCP_TOKEN" \
   -d '{}'

List MCP tools:

curl -s -X POST "$BASE_URL/sm_mcp/mcp" \
   -H "Content-Type: application/json" \
   -H "X-API-Key: $MCP_TOKEN" \
   -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

Count records:

curl -s -X POST "$BASE_URL/sm_mcp/mcp" \
   -H "Content-Type: application/json" \
   -H "X-API-Key: $MCP_TOKEN" \
   -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"odoo_count","arguments":{"model":"res.partner","domain":[]}}}'

Search and read records:

curl -s -X POST "$BASE_URL/sm_mcp/mcp" \
   -H "Content-Type: application/json" \
   -H "X-API-Key: $MCP_TOKEN" \
   -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"odoo_search_read","arguments":{"model":"res.partner","fields":["name","email"],"limit":5}}}'

11. Troubleshooting

12. License

This module is released under the Odoo Proprietary License v1.0 (OPL-1). Usage is governed by Odoo Apps Store licensing terms.