Allows AI agents to interact with an Odoo 19 ERP system, providing CRM tools to count, list, and create leads, as well as perform semantic search over lead notes.
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., "@Odoo MCP Server Can you list the top 5 leads by expected revenue?"
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.
An MCP (Model Context Protocol) server that exposes an Odoo 19 ERP as a set of standard tools — so any MCP-compatible AI agent (Claude Desktop, an IDE, a custom agent) can query and act on the ERP without writing a single line of custom integration.
MCP is the open standard adopted in 2026 by Anthropic, OpenAI, Google and Microsoft — often described as "the USB-C of AI". It turns the M×N integration problem into M+N: one server per data source, usable by every client.
Tool | What it does |
| Counts CRM leads, optionally filtered by AI temperature |
| Lists leads with company and expected revenue |
| Creates a new lead in the CRM |
| Semantic search over lead notes (RAG with pgvector) |
Related MCP server: odoo-mcp
(any agent) (this repo) + pgvector
The server runs as a separate process from Odoo and talks to it through Odoo's official external API (XML-RPC) — the same interface any third-party system would use. This keeps a clean client/server separation, as the protocol intends.
buscar_semantico reuses the RAG layer implemented in the companion module
odoo_ai_agent (local embeddings + pgvector).
Python 3.12, fastmcp
Transport: stdio (JSON-RPC)
Odoo 19 external API (XML-RPC)
PostgreSQL + pgvector for the semantic layer
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txtCreate a .env file (never committed):
ODOO_URL=http://localhost:8069 ODOO_DB=your_database ODOO_USER=your_odoo_user ODOO_PASSWORD=your_odoo_password
Run the test client to list and call the published tools:
python3 test_client.pyOr register the server with any MCP client by pointing it to server.py.
Credentials are loaded from environment variables / .env, never hardcoded.
The server only exposes explicitly declared tools — no arbitrary ORM access.
Salima Terbah — Multiplatform App Developer (DAM), specializing in applied AI for Odoo.
LGPL-3
Odoo ERP for AI agents: hosted OAuth endpoint, gated writes, one endpoint for every instance.
Let AI agents query data and act across all your business apps via MCP.
MCP server unifying ERPs, CRMs, APIs and knowledge base for Claude, ChatGPT and Gemini.
AI agent platform: manage leads, conversations, bots, calendar and CRM via MCP.
