MCP Odoo Bridge Server

You can use this MCP server to securely connect your AI assistant to your Odoo data, enabling natural language queries, reads, writes, and other model operations through standardized MCP endpoints and a simple local runtime.

How to use

To use the MCP Odoo Bridge Server, run the local MCP bridge process and connect your MCP client (such as Claude Desktop or VS Code extension) to the server. You will be able to search, read, count, create, update, and delete Odoo records, as well as explore models and fields and run custom methods when permitted. You authenticate via API keys or user credentials, and you operate within the security and auditing controls configured in your Odoo setup.

Typical usage flow: start the local MCP bridge, configure your MCP client to point at the local server, obtain or provide an API key, and begin issuing natural language requests or structured tool calls. The server enforces permissions aligned with the Odoo user and logs all actions for auditing.

How to install

Prerequisites you should prepare before installing: an Odoo instance (17.0, 18.0, or 19.0 recommended), Python 3.10 or newer, and access to install the AD Odoo MCP Bridge module in Odoo.

Step 1: Clone the MCP bridge server repository and navigate into it.

git clone https://github.com/yourusername/ad-mcp-bridge-server.git
cd ad-mcp-bridge-server

Step 2: Install the Python package in editable mode to pull in the server code and dependencies.

pip install -e .

Step 3: Install the Odoo module in your Odoo instance. Prepare the addons path, then install via the Apps interface.

- Add the module folder to your Odoo addons path
- Restart Odoo
- In Odoo, go to Apps → Remove the Apps filter → Search for MCP → Install

Configure and run the MCP bridge server

Configure the server to connect to Odoo by providing the required environment variables. You may start the server from a code editor, terminal, or a script.

The following example shows a local runtime configuration for Claude Desktop or an equivalent client that runs the server as a stdio process. Use the exact command, arguments, and environment shown here.

{
  "mcpServers": {
    "odoo": {
      "command": "python",
      "args": ["-m", "ad_mcp_bridge_server"],
      "cwd": "/path/to/ad-mcp-bridge-server/src",
      "env": {
        "ODOO_URL": "http://localhost:8069",
        "ODOO_DB": "your_database",
        "ODOO_API_KEY": "your-api-key"
      }
    }
  }
}

Configuration notes

Environment variables control how the MCP bridge connects to Odoo and how it authenticates requests. See the list of variables below for reference and adjust them to your environment.

Security and auditing

This server requires a valid API key for all requests. AI actions inherit the permissions of the connected Odoo user. All operations are audited with IP, timestamp, and details. Rate limits help prevent abuse, and you can block sensitive fields from being returned or manipulated.

API endpoints (Odoo module)

The Odoo module exposes a set of JSON-RPC endpoints that enable the MCP client to perform operations on Odoo data.

Development

Run the server locally for development and testing. Use environment variables to point to your local Odoo instance and start the Python module that provides the MCP bridge.

Notes on YOLO mode and transport

YOLO mode is a development/testing feature that bypasses security checks. It should never be used in production.

Transport settings determine how the MCP bridge communicates with clients. The default transport is stdio, but HTTP transport is supported for remote connections.

Troubleshooting

If you encounter authentication or permission errors, verify that the API key is valid and that the Odoo user has the required permissions for the requested actions. Check the audit logs for details and confirm that the MCP bridge is properly connected to Odoo and reachable at the configured URL.

Examples and tips

Create a new CRM lead, query order statuses, or fetch model fields by describing your intent in natural language. The bridge translates your requests into Odoo operations while enforcing configured permissions.

Available tools

health

Health check endpoint for server availability

info

Server information endpoint

models

List enabled models available to MCP clients

fields

Retrieve fields for a specific model

search

Search records using criteria or natural language

read

Read a record by ID

count

Count records matching criteria

create

Create a new record with provided data

write

Update an existing record with new data

unlink

Delete a record by ID

execute

Execute a server-side method on a record