Provides comprehensive integration with Odoo ERP systems, enabling AI assistants to search employees, manage holidays, execute custom methods on Odoo models, access records and data structures, and interact with all Odoo functionality through XML-RPC communication.
Odoo MCP Server Advanced
Two tools. Infinite possibilities. Full Odoo API access.
An advanced MCP (Model Context Protocol) server implementation for Odoo ERP systems, enabling AI assistants to interact with Odoo data and functionality through the standardized Model Context Protocol.
Forked from - Thanks to LΓͺ Anh TuαΊ₯n for the excellent foundation.
π― Philosophy: Simplicity & Power
Connect AI assistants to Odoo with just two universal tools:
execute_method
- Call any Odoo method on any modelbatch_execute
- Execute multiple operations atomically
No complexity. No limitations. Full Odoo API access.
What You Can Do
Everything you need to automate, query, and manage your Odoo instance through AI.
π Quick Start
Installation
Option 1: Traditional pip install
Option 2: Using uvx (No Installation)
Configuration
Create a .env
file:
Run Server
Claude Desktop Setup
Option 1: Using local installation
Add to claude_desktop_config.json
:
Option 2: Using uvx (Simpler Alternative)
π§ The Two Tools
1. execute_method - The Universal Powerhouse
Execute ANY Odoo method on ANY model. Full API access. No limitations.
Examples:
2. batch_execute - Atomic Transactions
Execute multiple operations atomically. All succeed or all rollback.
π Documentation
Essential Resources
Before using the tools, check these resources:
odoo://model/{model}/schema
- Field definitions, relationships, required fieldsodoo://model/{model}/access
- Your permissions (read/write/create/delete)odoo://methods/{model}
- Available methods for a modelodoo://workflows
- Business workflows (Sales, CRM, Inventory, etc.)odoo://server/info
- Odoo version and installed modules
The Cookbook
π COOKBOOK.md - 40+ practical examples:
Searching & filtering
Creating records
Updating & deleting
Working with relationships
Business workflows
Batch operations
Advanced patterns
Start here! The cookbook shows you how to accomplish anything with just 2 tools.
Prompts
User-selectable templates in Claude's menu:
search-customers
- Find customers with filterscreate-sales-order
- Create sales orders step-by-stepodoo-exploration
- Discover your Odoo instance capabilities
π Learn by Example
Example 1: Find Employees
Example 2: Time Off Requests
Example 3: Create Customer + Order (Atomic)
π‘ Why This Design Works
β Key Benefits
1. Universal Access
Full Odoo API at your fingertips
No artificial limitations
Do anything Odoo can do
2. Simple & Predictable
Learn 2 tools, use everywhere
Clear mental model
Easy to debug and maintain
3. Reliable
Odoo provides excellent native error messages
Direct API access means fewer points of failure
Stable, production-ready implementation
4. Flexible
Works with any Odoo version (14+)
Supports all Odoo models and methods
Extensible through Odoo's native capabilities
π₯ Features
AI Integration
Claude Desktop Ready: Seamless integration with Claude Code
Two Universal Tools: Access the entire Odoo API with
execute_method
andbatch_execute
Smart Limits: Automatic protection against oversized queries (configurable)
MCP 2025 Compliant: Latest Model Context Protocol specification
Multiple Connection Options
STDIO: Direct integration with Claude Desktop
SSE: Server-Sent Events for web browsers (port 8009)
HTTP: Streamable HTTP for API integrations (port 8008)
Docker: Pre-built containers for all transports
Enterprise Ready
Odoo 14+: Works with all modern Odoo versions
JSON-2 API: Support for Odoo 19+ Bearer token authentication
Flexible Auth: Environment variables or config files
Enhanced Logging: Timestamped logs in
./logs/
Proxy Support: HTTP proxy configuration
SSL Control: Configurable SSL verification
Python 3.10-3.13: Tested on all current Python versions
π Advanced Usage
Odoo 19+ JSON-2 API (Recommended)
For better security with Odoo 19+:
Benefits:
Bearer token authentication (more secure)
Better performance
Future-proof (JSON-RPC deprecated in Odoo 20)
Docker Deployment
Domain Operators
Common search operators:
Operator | Description | Example |
| Equal |
|
| Not equal |
|
,
,
,
| Comparison |
|
,
| Pattern match |
|
,
| In list |
|
π Documentation
New to Odoo MCP Server? Start here:
USER_GUIDE.md - Complete setup guide with 5-minute quick-start
COOKBOOK.md - 45+ practical examples for common tasks
TRANSPORTS.md - Connection options (STDIO, SSE, HTTP)
CLAUDE.md - Technical reference and architecture
CHANGELOG.md - Version history and updates
π€ Contributing
Contributions welcome! Please:
Fork the repository
Create feature branch (
git checkout -b feature/amazing
)Commit changes (
git commit -m 'Add amazing feature'
)Push to branch (
git push origin feature/amazing
)Open Pull Request
Development philosophy:
Simplicity first
Universal tools over specialized ones
Documentation over complexity
Reliability through directness
π License
MIT License - See LICENSE file
π Acknowledgments
Original project by LΓͺ Anh TuαΊ₯n
Built with FastMCP
Follows Model Context Protocol specification
π― What's Next?
Ready to get started?
Quick Setup: Follow the USER_GUIDE.md 5-minute quick-start
Learn by Example: Browse COOKBOOK.md for 45+ recipes
Explore Your Odoo: Use the
odoo-exploration
prompt in ClaudeBuild & Automate: Create custom workflows with
execute_method
Need help?
π Check the USER_GUIDE.md troubleshooting section
π¬ Open an issue on GitHub
π Star the repo if you find it useful!
Connect AI to Odoo. Build the future. π
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Enables AI assistants to interact with Odoo ERP systems through the Model Context Protocol. Provides comprehensive access to Odoo models, records, and methods with enhanced features like employee search, holiday management, and flexible domain querying.