MCP Odoo Bridge Server MCP Server

Local setup required. This server has to be cloned and prepared on your machine before you register it in Claude Code.
1

Set the server up locally

Run this once to clone and prepare the server before adding it to Claude Code.

Run in terminal
pip install -e .
2

Register it in Claude Code

After the local setup is done, run this command to point Claude Code at the built server.

Run in terminal
claude mcp add -e "ODOO_URL=${ODOO_URL}" odoo-mcp-bridge -- node "<FULL_PATH_TO_AD_MCP_BRIDGE_SERVER>/dist/index.js"

Replace <FULL_PATH_TO_AD_MCP_BRIDGE_SERVER>/dist/index.js with the actual folder you prepared in step 1.

Required:ODOO_URL+ 4 optional
README.md

Enables AI assistants to interact with Odoo data using natural language

MCP Odoo Bridge Server

Licensed under the Apache License, Version 2.0 - See LICENSE for details.

A Model Context Protocol (MCP) server that enables AI assistants like Claude to interact with Odoo data using natural language.

🎯 What is MCP?

The Model Context Protocol is an open standard by Anthropic that enables AI assistants to securely connect to external data sources. This server acts as a bridge between Claude (or other MCP clients) and your Odoo instance.

Learn more: MCP Documentation

✨ Features

Feature Description
🔍 Search Records Find records using natural language or Odoo domain syntax
📖 Read Records Get detailed record information by ID
📊 Count Records Get counts matching criteria
➕ Create Records Create new records (with permission)
✏️ Update Records Modify existing records (with permission)
🗑️ Delete Records Remove records (with permission)
📋 List Models Discover available models
🔧 Get Fields Understand model structure
⚡ Execute Methods Run custom methods (if enabled)
🔐 API Key Auth Secure authentication via API keys
📝 Audit Logging All operations logged for compliance

📋 Prerequisites

  1. Odoo instance (17.0, 18.0, or 19.0 recommended)
  2. Python 3.10+ installed
  3. AD Odoo MCP Bridge module installed in Odoo (see Odoo Module)

🚀 Installation

1. Clone the Repository

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

2. Install Dependencies

pip install -e .

Or with uv:

uv pip install -e .

3. Install the Odoo Module

Install the ad_odoo_mcp_bridge module in your Odoo instance:

  1. Add the module folder to your Odoo addons path
  2. Go to Apps → Install "AD Odoo MCP Bridge"

⚙️ Configuration

Environment Variables

The server requires the following environment variables:

Variable Required Description Example
ODOO_URL Yes Your Odoo instance URL https://mycompany.odoo.com
ODOO_API_KEY Yes* API key for authentication 0ef5b399e9ee9c11b053dfb6eeba8de473c29fcd
ODOO_USER Yes* Username (if not using API key) admin
ODOO_PASSWORD Yes* Password (if not using API key) admin
ODOO_DB No Database name (auto-detected if not set) mycompany
ODOO_MAX_RECORDS No Default max records per query (default: 100) 200
ODOO_TIMEOUT No Request timeout in seconds (default: 30) 60
ODOO_YOLO No YOLO mode - bypasses MCP security (⚠️ DEV ONLY) off, read, true

* Authentication: You must provide either ODOO_API_KEY or both ODOO_USER and ODOO_PASSWORD.

MCP Transport Options
Variable Required Description Example
MCP_TRANSPORT No Transport type: stdio or streamable-http (default: stdio) streamable-http
MCP_HOST No Host for HTTP transport (default: localhost) 0.0.0.0
MCP_PORT No Port for HTTP transport (default: 8000) 8080
YOLO Mode Values
Value Description
off All operations require explicit MCP Bridge permissions (default)
read Allows read-only operations on all models without configuration
true ⚠️ DANGEROUS - Allows all operations including write/delete without restrictions

⚠️ Warning: YOLO mode bypasses security checks and should NEVER be used in production. It's intended only for local development and testing.

Create a `.env` File (Optional)

ODOO_URL=https://mycompany.odoo.com
ODOO_DB=mycompany
ODOO_API_KEY=your-api-key-here

🔌 Usage with Claude Desktop

Step 1: Generate API Key in Odoo

  1. Go to MCP Bridge → Configuration → API Keys
  2. Click Create → Select user → Generate Key
  3. Copy the key (shown only once!)

Step 2: Configure Claude Desktop

Edit claude_desktop_config.json:

Windows: %APPDATA%\Claude\claude_desktop_config.json
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "odoo": {
      "command": "python",
      "args": ["-m", "ad_mcp_bridge_server"],
      "cwd": "/path/to/ad-mcp-bridge-server/src",

Tools (5)

search_recordsFind records using natural language or Odoo domain syntax
read_recordsGet detailed record information by ID
create_recordsCreate new records in Odoo
update_recordsModify existing records
delete_recordsRemove records from Odoo

Environment Variables

ODOO_URLrequiredYour Odoo instance URL
ODOO_API_KEYAPI key for authentication
ODOO_USERUsername for authentication
ODOO_PASSWORDPassword for authentication
ODOO_DBDatabase name

Configuration

claude_desktop_config.json
{"mcpServers": {"odoo": {"command": "python", "args": ["-m", "ad_mcp_bridge_server"], "env": {"ODOO_URL": "https://mycompany.odoo.com", "ODOO_API_KEY": "your-api-key-here"}}}}

Try it

→Find all sales orders created in the last 7 days.
→Create a new customer record for 'Acme Corp' with the email contact@acme.com.
→Update the status of lead ID 45 to 'Qualified'.
→List all available Odoo models to see what data I can access.
→Count how many open support tickets are currently assigned to the support team.

Frequently Asked Questions

What are the key features of MCP Odoo Bridge Server?

Search and filter Odoo records using natural language. Perform CRUD operations (Create, Read, Update, Delete) on Odoo models. Discover model structure and available fields. Secure authentication via Odoo API keys. Audit logging for all operations.

What can I use MCP Odoo Bridge Server for?

Automating data entry for sales leads directly from chat. Querying inventory levels or product details during customer support sessions. Updating project task statuses without leaving the AI interface. Generating quick reports on business performance metrics.

How do I install MCP Odoo Bridge Server?

Install MCP Odoo Bridge Server by running: pip install -e .

What MCP clients work with MCP Odoo Bridge Server?

MCP Odoo Bridge Server works with any MCP-compatible client including Claude Desktop, Claude Code, Cursor, and other editors with MCP support.

Turn this server into reusable context

Keep MCP Odoo Bridge Server docs, env vars, and workflow notes in Conare so your agent carries them across sessions.

Need the old visual installer? Open Conare IDE.
Open Conare
View all database servers →

Related MCP Servers

ArcadeDB
Multi Model DBMS Built for Extreme Performance
database758 stars
MariaDB MCP Server
Manage and query MariaDB databases with SQL and vector search capabilities.
database151 stars
GoSQLX
Production-ready SQL parsing SDK for Go with 7 SQL tools
database61 stars
Altinity MCP
Interact with ClickHouse databases through the Model Context Protocol
database23 stars
Apache Superset
Full-featured MCP server for Apache Superset with 128+ tools
database21 stars
Bonnard
Self-hosted semantic layer for AI agents.
database19 stars