Enables interaction with Odoo data, allowing for searching, reading, counting, creating, updating, and deleting records, as well as discovering model structures and executing custom methods.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@MCP Odoo Bridge Server Find all recent sales orders for Azure Interior"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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.
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
Related MCP server: Odoo MCP Server
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 |
Odoo instance (17.0, 18.0, or 19.0 recommended)
Python 3.10+ installed
AD Odoo MCP Bridge module installed in Odoo (see Odoo Module)
git clone https://github.com/yourusername/ad-mcp-bridge-server.git
cd ad-mcp-bridge-serverpip install -e .Or with uv:
uv pip install -e .Install the ad_odoo_mcp_bridge module in your Odoo instance:
Add the module folder to your Odoo addons path
Go to Apps → Install "AD Odoo MCP Bridge"
The server requires the following environment variables:
Variable | Required | Description | Example |
| Yes | Your Odoo instance URL |
|
| Yes* | API key for authentication |
|
| Yes* | Username (if not using API key) |
|
| Yes* | Password (if not using API key) |
|
| No | Database name (auto-detected if not set) |
|
| No | Default max records per query (default: |
|
| No | Request timeout in seconds (default: |
|
| No | YOLO mode - bypasses MCP security (⚠️ DEV ONLY) |
|
* Authentication: You must provide either
ODOO_API_KEYor bothODOO_USERandODOO_PASSWORD.
Variable | Required | Description | Example |
| No | Transport type: |
|
| No | Host for HTTP transport (default: |
|
| No | Port for HTTP transport (default: |
|
Value | Description |
| All operations require explicit MCP Bridge permissions (default) |
| Allows read-only operations on all models without configuration |
| ⚠️ 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.
.env File (Optional)ODOO_URL=https://mycompany.odoo.com
ODOO_DB=mycompany
ODOO_API_KEY=your-api-key-hereGo to MCP Bridge → Configuration → API Keys
Click Create → Select user → Generate Key
Copy the key (shown only once!)
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",
"env": {
"ODOO_URL": "http://localhost:8069",
"ODOO_DB": "your_database",
"ODOO_API_KEY": "your-api-key"
}
}
}
}Windows Note: Use the full Python path if needed:
"command": "C:\\path\\to\\venv\\Scripts\\python.exe"
Close and reopen Claude Desktop. You should see the 🔧 Tools icon.
Try these prompts:
"Show me all customers from the United States"
"What's the status of order SO/2024/0153?"
"Create a new lead for ABC Company"
"How many unpaid invoices do we have?"
Create .vscode/mcp.json in your workspace:
{
"servers": {
"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"
}
}
}
}Use the official MCP debugging tool:
npx @modelcontextprotocol/inspector python -m ad_mcp_bridge_serverThis opens a web UI to test all tools interactively.
This MCP server requires the AD Odoo MCP Bridge module installed in Odoo.
Odoo Version | Status |
19.0 | ✅ Fully Supported |
18.0 | ✅ Supported |
17.0 | ✅ Supported |
16.0 | ✅ Supported |
Model Configuration: Choose which models AI can access
Permission Control: Set read/create/update/delete per model
API Key Management: Generate and manage API keys
Audit Logging: Track all AI operations
Rate Limiting: Control request frequency
YOLO Mode: Quick access mode for development
Copy ad_odoo_mcp_bridge folder to your Odoo addons path
Restart Odoo
Go to Apps → Remove "Apps" filter → Search "MCP" → Install
API Key Authentication: All requests require a valid API key
Permission Inheritance: AI inherits Odoo user's permissions
Audit Trail: All operations logged with IP, timestamp, and details
Rate Limiting: Configurable per-key request limits
Field Exclusions: Sensitive fields can be blocked
The Odoo module exposes these JSON-RPC endpoints:
Endpoint | Description |
| Health check |
| Server information |
| List enabled models |
| Get model fields |
| Search records |
| Read record by ID |
| Count records |
| Create record |
| Update record |
| Delete record |
| Execute method |
cd src
export ODOO_URL=http://localhost:8069
export ODOO_DB=mydb
export ODOO_API_KEY=your-key
python -m ad_mcp_bridge_serverad-mcp-bridge-server/
├── src/
│ └── ad_mcp_bridge_server/
│ ├── __init__.py
│ ├── __main__.py # Entry point
│ ├── config.py # Pydantic settings
│ ├── odoo_client.py # Odoo HTTP client
│ └── server.py # MCP server & tools
├── pyproject.toml
├── README.md
└── .env.exampleContributions are welcome! Please feel free to submit a Pull Request.
Fork the repository
Create your feature branch (git checkout -b feature/amazing-feature)
Commit your changes (git commit -m 'Add some amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request
Thank you for using this project! If you find it helpful and would like to support my work, kindly consider buying me a coffee. Your support is greatly appreciated!
And don't forget to give the project a ⭐ star if you like it!
This project is licensed under the Apache License 2.0 - see the LICENSE file for details.
A Model Context Protocol (MCP) server that enables AI assistants to securely interact with Odoo ERP systems through standardized resources and tools for data retrieval and manipulation.
Made with ❤️ for the Odoo and AI community
Count records matching a domain.
Args:
model: The Odoo model name
domain: Search filter as Odoo domain list
Returns:
Number of matching records
Example:
Count unpaid invoices: model='account.move', domain=[['payment_state', '!=', 'paid']]
Inputs: model (required), domain. Returns: result
Create a new record in Odoo.
Args:
model: The Odoo model name
values: Dictionary of field values for the new record
Returns:
Success message with the new record ID
Example:
Create customer: model='res.partner', values={'name': 'New Customer', 'email': 'new@example.com'}
Inputs: model (required), values (required). Returns: result
Delete a record from Odoo.
Args:
model: The Odoo model name
record_id: The ID of the record to delete
Returns:
Success message
⚠️ WARNING: This action is irreversible!
Inputs: model (required), record_id (required). Returns: result
Execute a custom method on an Odoo model.
Args:
model: The Odoo model name
method: The method name to call
record_ids: Optional list of record IDs to call the method on
args: Positional arguments for the method
kwargs: Keyword arguments for the method
Returns:
Method result
⚠️ Note: This requires special permission in Odoo settings.
Example:
Confirm sale order: model='sale.order', method='action_confirm', record_ids=[5]
Inputs: model (required), method (required), record_ids, args, +1 more. Returns: result
Get field definitions for an Odoo model.
Args:
model: The Odoo model name
field_types: Optional list of types to filter (e.g., ['many2one', 'char'])
Returns:
List of fields with their types and descriptions
Inputs: model (required), field_types. Returns: result
Get a specific record by ID.
Args:
model: The Odoo model name
record_id: The ID of the record to retrieve
fields: List of fields to return (empty = all accessible fields)
Returns:
JSON object with the record data
Example:
Get customer details: model='res.partner', record_id=5
Inputs: model (required), record_id (required), fields. Returns: result
Get the display name of a record (useful for looking up references).
Args:
model: The Odoo model name
record_id: The record ID
Returns:
Display name of the record
Inputs: model (required), record_id (required). Returns: result
List all Odoo models available for MCP access.
Returns:
List of models with their permissions (read, create, update, delete)
Inputs: no named parameters. Returns: result
Search and return the first matching record (convenience method).
Args:
model: The Odoo model name
domain: Search filter as Odoo domain list
fields: List of fields to return
Returns:
The first matching record or a message if not found
Inputs: model (required), domain (required), fields. Returns: result
Search for records in an Odoo model.
Args:
model: The Odoo model name (e.g., 'res.partner', 'sale.order')
domain: Search filter as Odoo domain list (e.g., [['is_company', '=', True]])
Common operators: =, !=, >, <, >=, <=, like, ilike, in, not in
fields: List of fields to return (empty = smart defaults)
limit: Maximum records to return (default 80)
offset: Number of records to skip (for pagination)
order: Sort order (e.g., 'name asc, id desc')
Returns:
JSON list of matching records
Examples:
- Find all companies: model='res.partner', domain=[['is_company', '=', True]]
- Find orders from this month: model='sale.order', domain=[['date_order', '>=', '2024-01-01']]
- Find unpaid invoices: model='account.move', domain=[['payment_state', '!=', 'paid']]
Inputs: model (required), domain, fields, limit, +2 more. Returns: result
Update an existing record in Odoo.
Args:
model: The Odoo model name
record_id: The ID of the record to update
values: Dictionary of field values to update
Returns:
Success message
Example:
Update customer phone: model='res.partner', record_id=5, values={'phone': '123-456-7890'}
Inputs: model (required), record_id (required), values (required). Returns: result
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 11 tools
Every tool has a clearly distinct purpose with no ambiguity. Core CRUD operations (create_record, get_record, update_record, delete_record) are separate from search operations (search_records, search_and_read_one, count_records), metadata tools (list_models, get_model_fields), and specialized utilities (execute_method, get_record_name). The descriptions clearly differentiate each tool's specific function.
All tools follow a consistent verb_noun naming pattern throughout (e.g., count_records, create_record, search_records). The naming is perfectly uniform with no deviations in style or convention, making the tool set highly predictable and readable.
With 11 tools, this server is well-scoped for its purpose as an Odoo bridge. It provides comprehensive coverage of database operations (CRUD, search, count), metadata access, and specialized utilities without being overwhelming. Each tool earns its place in the set.
The tool surface provides complete CRUD/lifecycle coverage for the Odoo domain with no obvious gaps. It includes all essential operations (create, read, update, delete, search, count), metadata tools for discovery, and specialized utilities like execute_method for custom actions. The set enables full agent workflows without dead ends.
Odoo MCP connector for ChatGPT and Claude: ask sales, invoices and stock in plain words. Read-only.
Odoo virtual employee via MCP: query, create, modify records, workflows, PDFs, and activities.
Read, write and run Odoo actions from any AI app, as each user, with approval rules per colleague.
Connect any AI assistant to Odoo 16–19 via OAuth 2.0 + PKCE. 400 free calls, no local install.
