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 "Install 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 ServerFind 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.
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
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)
🚀 Installation
1. Clone the Repository
2. Install Dependencies
Or with uv:
3. Install the Odoo Module
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"
⚙️ Configuration
Environment Variables
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.
MCP Transport Options
Variable | Required | Description | Example |
| No | Transport type: |
|
| No | Host for HTTP transport (default: |
|
| No | Port for HTTP transport (default: |
|
YOLO Mode Values
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.
Create a .env File (Optional)
🔌 Usage with Claude Desktop
Step 1: Generate API Key in Odoo
Go to MCP Bridge → Configuration → API Keys
Click Create → Select user → Generate Key
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
Windows Note: Use the full Python path if needed:
"command": "C:\\path\\to\\venv\\Scripts\\python.exe"
Step 3: Restart Claude Desktop
Close and reopen Claude Desktop. You should see the 🔧 Tools icon.
Step 4: Start Chatting!
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?"
🔌 Usage with VS Code
Create .vscode/mcp.json in your workspace:
🧪 Testing with MCP Inspector
Use the official MCP debugging tool:
This opens a web UI to test all tools interactively.
🏗️ Odoo Module
This MCP server requires the AD Odoo MCP Bridge module installed in Odoo.
Compatibility
Odoo Version | Status |
19.0 | ✅ Fully Supported |
18.0 | ✅ Supported |
17.0 | ✅ Supported |
16.0 | ✅ Supported |
Module Features
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
Module Installation
Copy
ad_odoo_mcp_bridgefolder to your Odoo addons pathRestart Odoo
Go to Apps → Remove "Apps" filter → Search "MCP" → Install
🔐 Security
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
📚 API Endpoints (Odoo Module)
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 |
🛠️ Development
Run Locally
Project Structure
📖 MCP Resources
🤝 Contributing
Contributions 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
☕ Support
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!
📄 License
This project is licensed under the Apache License 2.0 - see the LICENSE file for details.
🙏 Acknowledgments
📝 About
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