| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Lines of code | 236 |
| Technical Name |
mcp_base |
| License | LGPL-3 |
| Website | https://github.com/chrisking94/odoo_addons/tree/main/mcp_base |
| Versions | 12.0 13.0 14.0 15.0 16.0 17.0 18.0 19.0 |
Odoo MCP Framework
Connect Odoo to AI Agents with One Line of Code. Transform your Odoo into a Model Context Protocol (MCP) Server for seamless integration with Claude, ChatGPT, Cursor and other AI agents.
Simple. Elegant. Powerful.
AI Integration, MCP Server, LLM Connector, Automation
One Decorator, AI Ready
@mcp_tool(description="Search customers by name") def search_customers(self, name: str): # That's it! Your method is now AI-ready
Why Choose This?
Transform your Odoo into an AI-ready MCP Server instantly. No complex configuration, no boilerplate code - just decorate and go.
Minimal Setup
Just one decorator. Your methods are ready for AI agents.
Type Safe
Automatic schema generation from Python type hints.
Production Ready
Streamable HTTP, JSON-RPC 2.0, enterprise-grade reliability.
Zero Config
Install and start decorating. No additional setup required.
How Simple Is It?
Import the decorator
One simple import statement
Add @mcp_tool
Describe what it does in plain English
Done!
AI agents can now call it at /mcp
from odoo.addons.mcp_base import mcp_tool
from odoo import models
class ResPartner(models.Model):
_inherit = 'res.partner'
@mcp_tool(description="Search customers by name")
def search_customers(self, name: str):
"""AI agents can call this method directly!"""
partners = self.search([('name', 'ilike', name)])
return [
{'id': p.id, 'name': p.name, 'email': p.email}
for p in partners
]
What You Get
- Expose any Odoo model method to AI agents effortlessly
- Automatic JSON schema from Python type annotations
- Built-in Streamable HTTP transport (MCP 2025-03-26)
- Full JSON-RPC 2.0 protocol compliance
- Works seamlessly with Claude, ChatGPT, and other LLMs
- No external dependencies beyond Odoo core
Ideal for: AI-powered customer service bots, intelligent sales assistants, automated inventory management, smart reporting dashboards, natural language ERP queries, and any use case where you want AI to interact with your Odoo data.
Client Configuration
Connect your favorite AI clients to Odoo MCP Server in minutes.
ChatWise
Add MCP Server Streamable HTTP Enter URL
Cursor
Settings MCP Add Server Streamable HTTP
Claude Desktop
Edit config.json Add MCP server
Tip: Your MCP endpoint will be: http://your-odoo-server:8069/mcp
Security & Authentication
Protect your Odoo data with proper authentication. We strongly recommend using API key authentication for production environments.
Important: If the auth_api_key module is not installed, the MCP server runs with administrator privileges. This is convenient for development but NOT recommended for production.
Production Setup (Strongly Recommended)
Install auth_api_key
Get it from Odoo App Store
Create API Key
Settings Technical API Keys
Configure Client
Add Api-Key header to requests
Api-Key: your-api-key-here
With auth_api_key Installed
API key required User-level permissions Production-ready Secure
Without auth_api_key
No authentication Admin privileges Development only Security risk
Secure Your MCP Server Today
Install auth_api_key and protect your Odoo data with enterprise-grade authentication.
Ready to Make Your Odoo AI-Ready?
Install Odoo MCP Framework and expose your first method in under 2 minutes.
Star on GitHub
Please log in to comment on this module