odoo-mcp-server
This server lets Claude interact with an Odoo ERP instance through MCP tools, enabling autonomous CRM, sales, project, inventory, and purchasing operations.
Verify connectivity and Odoo version via
odoo_ping.CRM & Sales: list, create, and update leads/opportunities; list sales orders; create quotations/sales orders with product lines.
Projects & Tasks: list projects/tasks with filters; create and update tasks (e.g., change kanban stage); post/read/delete chatter messages; mention partners; search partners; log timesheet entries.
Inventory & Purchasing: list products with stock availability (including low-stock filter); list purchase orders; create purchase orders with lines.
Uses XML-RPC authentication with Odoo via API key or password, configured through
.env, so no Odoo module installation is required.
Provides tools for interacting with Odoo ERP, enabling management of CRM leads and sales orders, projects and tasks, and inventory and purchase orders.
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 create a new lead for John Doe from ACME Corp"
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.
odoo-mcp-server
Servidor MCP (Model Context Protocol) que conecta Claude — Desktop, Cowork o Claude Code — con Odoo ERP vía XML-RPC, sin necesidad de instalar ningún módulo dentro de Odoo.
Pensado especialmente para usarse con tareas programadas de Cowork: que Claude cree leads, mueva tareas de proyecto o consulte stock de forma autónoma, en horario definido.
Características
Conexión estándar por XML-RPC (
/xmlrpc/2/commony/xmlrpc/2/object), compatible con Odoo Community y Enterprise, self-hosted u Odoo.sh/Odoo Online.Autenticación por API Key (no expone tu contraseña).
Tools organizadas por área:
CRM y Ventas: leads/oportunidades, cotizaciones y pedidos de venta.
Proyectos y Tareas: proyectos, tareas, asignación de responsables, cambio de etapa.
Inventario y Compras: stock de productos, órdenes de compra.
Configuración de credenciales 100% vía
.env(nunca hardcodeadas ni versionadas).
Related MCP server: Odoo MCP Unified Server
Instalación
Requiere Python 3.10+.
git clone <url-del-repo>
cd odoo-mcp-server
pip install -e .Configuración
Copia el archivo de ejemplo:
cp .env.example .envCompleta
.envcon los datos de tu instancia. Hay dos formas de autenticar, elige una:Opción A — API Key (recomendada)
ODOO_URL=https://tuinstancia.odoo.com ODOO_DB=nombre_de_tu_bd ODOO_USERNAME=usuario@tuempresa.com ODOO_API_KEY=tu_api_key_aquiLa API Key se genera en Odoo desde Ajustes → Usuarios → (tu usuario) → pestaña "Seguridad de la cuenta" → Claves API → Nueva clave API. Es revocable sin tocar tu contraseña de login, y es la forma recomendada para producción.
Opción B — Password (si no tienes acceso para generar una API Key)
ODOO_URL=https://tuinstancia.odoo.com ODOO_DB=nombre_de_tu_bd ODOO_USERNAME=usuario@tuempresa.com ODOO_PASSWORD=tu_passwordDeja
ODOO_API_KEYvacío o sin definir. Funciona igual (Odoo acepta password en el mismo parámetro de autenticación XML-RPC), pero es menos seguro: revocar el acceso implica cambiar tu contraseña de login, y si el password se filtra, compromete la cuenta completa (no solo el conector). Útil sobre todo para probar rápido contra una instancia local/dev, como en este mismo repo lo hicimos durante el desarrollo.Si ambas variables están presentes,
ODOO_API_KEYtiene prioridad.Instancia local con certificado self-signed o sin HTTPS real: revisa también
ODOO_VERIFY_SSLy la nota sobrehttp://vshttps://en Troubleshooting — es el error más común al conectar contra una instancia local..envya está en.gitignore— nunca se sube al repositorio.
Uso con Claude Desktop / Cowork
Agrega el servidor a tu claude_desktop_config.json:
{
"mcpServers": {
"odoo": {
"command": "odoo-mcp-server"
}
}
}O, si prefieres no instalarlo globalmente, apuntando al intérprete del entorno virtual:
{
"mcpServers": {
"odoo": {
"command": "/ruta/a/tu/venv/bin/odoo-mcp-server"
}
}
}Reinicia Claude Desktop (cierra la app desde el ícono de la bandeja del sistema con Quit/Salir — cerrar solo la ventana no recarga la configuración) y el conector debería aparecer disponible.
Windows + WSL
Si instalaste el venv dentro de WSL pero Claude Desktop corre nativo en Windows, invócalo a través de wsl.exe apuntando directo al Python del venv (evita bash -lc: un shell de login puede imprimir texto extra en stdout — motd, prompts de activación, etc. — y eso rompe el protocolo MCP, que exige stdout limpio):
{
"mcpServers": {
"odoo": {
"command": "wsl.exe",
"args": [
"-e",
"/ruta/wsl/a/tu/proyecto/odoo-mcp-server/venv/bin/python3",
"-m",
"odoo_mcp.server"
]
}
}
}La ruta del proyecto en formato WSL para una carpeta de Windows es /mnt/c/Users/TuUsuario/....
Verificar conexión
Con el .env configurado, puedes probar el arranque manualmente:
python -m odoo_mcp.serverDesde Claude, invoca el tool odoo_ping para confirmar conectividad y ver la versión de tu instancia Odoo.
Tools disponibles
CRM y Ventas
Tool | Descripción |
| Lista leads/oportunidades, con filtros por etapa, vendedor y tipo. |
| Crea un lead u oportunidad nuevo. |
| Actualiza campos de un lead existente. |
| Lista cotizaciones/pedidos de venta. |
| Crea una cotización con líneas de producto. |
Proyectos y Tareas
Tool | Descripción |
| Lista proyectos. |
| Lista tareas, con filtros por proyecto, responsable y etapa. |
| Crea una tarea dentro de un proyecto. |
| Actualiza una tarea (ej. cambiar de etapa/kanban). |
| Publica un mensaje o nota en el chatter de una tarea. Soporta |
| Lee los mensajes y notas del chatter de una tarea (para revisar lo publicado antes de sumar más). |
| Elimina un mensaje del chatter por ID (para corregir publicaciones). |
| Busca contactos/usuarios (res.partner) por nombre, para usarlos como |
| Registra una línea de hoja de horas (account.analytic.line) sobre una tarea. |
Inventario y Compras
Tool | Descripción |
| Lista productos y su stock disponible. |
| Lista órdenes de compra. |
| Crea una orden de compra con líneas. |
General
Tool | Descripción |
| Verifica conectividad y devuelve la versión de Odoo. |
Troubleshooting
SSLEOFError: UNEXPECTED_EOF_WHILE_READING
No es un problema de certificado: el servidor está respondiendo HTTP plano, no HTTPS, en esa URL/puerto (muy común en instancias locales o en Docker). Cambia ODOO_URL a http:// en vez de https://.
Autenticación rechazada por Odoo
Verifica ODOO_DB exacto (case-sensitive), y que ODOO_USERNAME + ODOO_API_KEY/ODOO_PASSWORD correspondan a un usuario activo con acceso a esa base de datos.
Error de certificado SSL contra una instancia https:// real
Si es una instancia local/dev con certificado self-signed, agrega ODOO_VERIFY_SSL=false al .env. Nunca lo desactives contra producción.
ConnectionRefusedError
El host/puerto no es alcanzable desde donde estás corriendo el conector. Si usas WSL contra un Odoo en Windows (o viceversa), confirma que el localhost se reenvía entre ambos (por defecto en WSL2 sí, pero revisa tu configuración de red si no).
ModuleNotFoundError: No module named 'mcp.server.fastmcp'
Se instaló mcp 2.x, que renombró FastMCP a MCPServer. Este proyecto fija mcp<2.0.0 en pyproject.toml; si ya tenías el venv creado desde antes, reinstala: pip install "mcp<2.0.0" --force-reinstall.
Server disconnected en Claude Desktop (sin más detalle)
Revisa los logs de MCP de la app (Settings → Developer → logs del servidor). Casi siempre es una excepción de Python al arrancar (dependencia faltante, .env no encontrado, credenciales inválidas) que se ve clara ahí. Evita invocar el server a través de un shell de login (bash -lc, zsh -l) — cualquier salida extra en stdout antes del JSON-RPC tumba la conexión.
Seguridad
Usa siempre una API Key dedicada, nunca tu contraseña de usuario.
Considera crear un usuario Odoo con permisos acotados (grupo específico) para el conector, en lugar de un administrador.
.envnunca debe subirse a git ni compartirse.
Licencia
MIT
odoo-mcp-server
Servidor MCP (Model Context Protocol) que conecta Claude — Desktop, Cowork o Claude Code — con Odoo ERP vía XML-RPC, sin necesidad de instalar ningún módulo dentro de Odoo.
Pensado especialmente para usarse con tareas programadas de Cowork: que Claude cree leads, mueva tareas de proyecto o consulte stock de forma autónoma, en horario definido.
Características
Conexión estándar por XML-RPC (
/xmlrpc/2/commony/xmlrpc/2/object), compatible con Odoo Community y Enterprise, self-hosted u Odoo.sh/Odoo Online.Autenticación por API Key (no expone tu contraseña).
Tools organizadas por área:
CRM y Ventas: leads/oportunidades, cotizaciones y pedidos de venta.
Proyectos y Tareas: proyectos, tareas, asignación de responsables, cambio de etapa.
Inventario y Compras: stock de productos, órdenes de compra.
Configuración de credenciales 100% vía
.env(nunca hardcodeadas ni versionadas).
Instalación
Requiere Python 3.10+.
git clone <url-del-repo>
cd odoo-mcp-server
pip install -e .Configuración
Copia el archivo de ejemplo:
cp .env.example .envCompleta
.envcon los datos de tu instancia. Hay dos formas de autenticar, elige una:Opción A — API Key (recomendada)
ODOO_URL=https://tuinstancia.odoo.com ODOO_DB=nombre_de_tu_bd ODOO_USERNAME=usuario@tuempresa.com ODOO_API_KEY=tu_api_key_aquiLa API Key se genera en Odoo desde Ajustes → Usuarios → (tu usuario) → pestaña "Seguridad de la cuenta" → Claves API → Nueva clave API. Es revocable sin tocar tu contraseña de login, y es la forma recomendada para producción.
Opción B — Password (si no tienes acceso para generar una API Key)
ODOO_URL=https://tuinstancia.odoo.com ODOO_DB=nombre_de_tu_bd ODOO_USERNAME=usuario@tuempresa.com ODOO_PASSWORD=tu_passwordDeja
ODOO_API_KEYvacío o sin definir. Funciona igual (Odoo acepta password en el mismo parámetro de autenticación XML-RPC), pero es menos seguro: revocar el acceso implica cambiar tu contraseña de login, y si el password se filtra, compromete la cuenta completa (no solo el conector). Útil sobre todo para probar rápido contra una instancia local/dev, como en este mismo repo lo hicimos durante el desarrollo.Si ambas variables están presentes,
ODOO_API_KEYtiene prioridad.Instancia local con certificado self-signed o sin HTTPS real: revisa también
ODOO_VERIFY_SSLy la nota sobrehttp://vshttps://en Troubleshooting — es el error más común al conectar contra una instancia local..envya está en.gitignore— nunca se sube al repositorio.
Uso con Claude Desktop / Cowork
Agrega el servidor a tu claude_desktop_config.json:
{
"mcpServers": {
"odoo": {
"command": "odoo-mcp-server"
}
}
}O, si prefieres no instalarlo globalmente, apuntando al intérprete del entorno virtual:
{
"mcpServers": {
"odoo": {
"command": "/ruta/a/tu/venv/bin/odoo-mcp-server"
}
}
}Reinicia Claude Desktop (cierra la app desde el ícono de la bandeja del sistema con Quit/Salir — cerrar solo la ventana no recarga la configuración) y el conector debería aparecer disponible.
Windows + WSL
Si instalaste el venv dentro de WSL pero Claude Desktop corre nativo en Windows, invócalo a través de wsl.exe apuntando directo al Python del venv (evita bash -lc: un shell de login puede imprimir texto extra en stdout — motd, prompts de activación, etc. — y eso rompe el protocolo MCP, que exige stdout limpio):
{
"mcpServers": {
"odoo": {
"command": "wsl.exe",
"args": [
"-e",
"/ruta/wsl/a/tu/proyecto/odoo-mcp-server/venv/bin/python3",
"-m",
"odoo_mcp.server"
]
}
}
}La ruta del proyecto en formato WSL para una carpeta de Windows es /mnt/c/Users/TuUsuario/....
Verificar conexión
Con el .env configurado, puedes probar el arranque manualmente:
python -m odoo_mcp.serverDesde Claude, invoca el tool odoo_ping para confirmar conectividad y ver la versión de tu instancia Odoo.
Tools disponibles
CRM y Ventas
Tool | Descripción |
| Lista leads/oportunidades, con filtros por etapa, vendedor y tipo. |
| Crea un lead u oportunidad nuevo. |
| Actualiza campos de un lead existente. |
| Lista cotizaciones/pedidos de venta. |
| Crea una cotización con líneas de producto. |
Proyectos y Tareas
Tool | Descripción |
| Lista proyectos. |
| Lista tareas, con filtros por proyecto, responsable y etapa. |
| Crea una tarea dentro de un proyecto. |
| Actualiza una tarea (ej. cambiar de etapa/kanban). |
| Publica un mensaje o nota en el chatter (mail.thread) de una tarea. |
| Elimina un mensaje del chatter por ID (para corregir publicaciones). |
| Registra una línea de hoja de horas (account.analytic.line) sobre una tarea. |
Inventario y Compras
Tool | Descripción |
| Lista productos y su stock disponible. |
| Lista órdenes de compra. |
| Crea una orden de compra con líneas. |
General
Tool | Descripción |
| Verifica conectividad y devuelve la versión de Odoo. |
Troubleshooting
SSLEOFError: UNEXPECTED_EOF_WHILE_READING
No es un problema de certificado: el servidor está respondiendo HTTP plano, no HTTPS, en esa URL/puerto (muy común en instancias locales o en Docker). Cambia ODOO_URL a http:// en vez de https://.
Autenticación rechazada por Odoo
Verifica ODOO_DB exacto (case-sensitive), y que ODOO_USERNAME + ODOO_API_KEY/ODOO_PASSWORD correspondan a un usuario activo con acceso a esa base de datos.
Error de certificado SSL contra una instancia https:// real
Si es una instancia local/dev con certificado self-signed, agrega ODOO_VERIFY_SSL=false al .env. Nunca lo desactives contra producción.
ConnectionRefusedError
El host/puerto no es alcanzable desde donde estás corriendo el conector. Si usas WSL contra un Odoo en Windows (o viceversa), confirma que el localhost se reenvía entre ambos (por defecto en WSL2 sí, pero revisa tu configuración de red si no).
ModuleNotFoundError: No module named 'mcp.server.fastmcp'
Se instaló mcp 2.x, que renombró FastMCP a MCPServer. Este proyecto fija mcp<2.0.0 en pyproject.toml; si ya tenías el venv creado desde antes, reinstala: pip install "mcp<2.0.0" --force-reinstall.
Server disconnected en Claude Desktop (sin más detalle)
Revisa los logs de MCP de la app (Settings → Developer → logs del servidor). Casi siempre es una excepción de Python al arrancar (dependencia faltante, .env no encontrado, credenciales inválidas) que se ve clara ahí. Evita invocar el server a través de un shell de login (bash -lc, zsh -l) — cualquier salida extra en stdout antes del JSON-RPC tumba la conexión.
Seguridad
Usa siempre una API Key dedicada, nunca tu contraseña de usuario.
Considera crear un usuario Odoo con permisos acotados (grupo específico) para el conector, en lugar de un administrador.
.envnunca debe subirse a git ni compartirse.
Licencia
MIT
Available Tools
13 toolsodoo_crm_create_leadA
Crea un nuevo lead u oportunidad en el CRM de Odoo.
Args: name: título/asunto del lead (requerido). partner_name: nombre de la empresa/contacto. email_from: email de contacto. phone: teléfono de contacto. expected_revenue: ingreso esperado, si aplica. type_: "lead" o "opportunity" (default "lead").
Inputs: name (required), phone, type_, email_from, +2 more. Returns: object
odoo_crm_list_leadsA
Lista leads/oportunidades de CRM (crm.lead) en Odoo.
Args: stage: filtra por nombre de etapa (ej. "New", "Won"). salesperson: filtra por nombre del vendedor asignado. only_opportunities: si True, solo trae oportunidades (type='opportunity'), excluyendo leads sin calificar. limit: máximo de registros a devolver (default 20).
Inputs: limit, stage, salesperson, only_opportunities. Returns: result
odoo_crm_update_leadA
Actualiza campos de un lead/oportunidad existente.
Args: lead_id: ID del registro crm.lead a modificar. values: diccionario de campo->valor a actualizar (ej. {"probability": 80, "expected_revenue": 5000}).
Inputs: values (required), lead_id (required). Returns: object
odoo_inventory_list_productsA
Lista productos y su disponibilidad en stock (product.product).
Args: name: filtra por nombre o referencia interna (búsqueda parcial). only_low_stock: si True, solo trae productos con qty_available <= 0. limit: máximo de registros a devolver (default 20).
Inputs: name, limit, only_low_stock. Returns: result
odoo_pingA
Verifica conectividad con la instancia Odoo configurada y devuelve su versión.
Inputs: no named parameters.
odoo_project_create_taskA
Crea una tarea (project.task) dentro de un proyecto Odoo.
Útil para que una tarea programada de Cowork registre trabajo pendiente directamente en Odoo.
Args: name: título de la tarea (requerido). project_id: ID del proyecto donde se crea. description: descripción/detalle de la tarea. assignee_id: ID del usuario (res.users) responsable. deadline: fecha límite en formato YYYY-MM-DD. priority: "0" (normal) o "1" (alta/estrella), default "0".
Inputs: name (required), project_id (required), deadline, priority, +2 more. Returns: object
odoo_project_list_projectsA
Lista proyectos (project.project) en Odoo.
Args: name: filtra por nombre del proyecto (búsqueda parcial). limit: máximo de registros a devolver (default 20).
Inputs: name, limit. Returns: result
odoo_project_list_tasksA
Lista tareas (project.task) de Odoo, opcionalmente filtradas.
Args: project_id: ID exacto del proyecto. project_name: nombre del proyecto (búsqueda parcial), alternativa a project_id. assignee: nombre del responsable asignado. stage: nombre de la etapa/columna kanban (ej. "In Progress", "Done"). limit: máximo de registros a devolver (default 30).
Inputs: limit, stage, assignee, project_id, +1 more. Returns: result
odoo_project_update_taskA
Actualiza campos de una tarea existente (ej. cambiar de etapa/estado).
Args: task_id: ID de la tarea (project.task) a modificar. values: diccionario de campo->valor a actualizar (ej. {"stage_id": 3} para mover de columna kanban).
Inputs: values (required), task_id (required). Returns: object
odoo_purchase_create_orderA
Crea una orden de compra (purchase.order) con sus líneas.
Args: supplier_id: ID del partner (res.partner) proveedor. order_lines: lista de líneas, cada una como {"product_id": , "product_qty": , "price_unit": }.
Inputs: order_lines (required), supplier_id (required). Returns: object
odoo_purchase_list_ordersA
Lista órdenes de compra (purchase.order).
Args: supplier: filtra por nombre del proveedor. state: filtra por estado ('draft', 'sent', 'purchase', 'done', 'cancel'). limit: máximo de registros a devolver (default 20).
Inputs: limit, state, supplier. Returns: result
odoo_sales_create_orderA
Crea una cotización/pedido de venta (sale.order) con sus líneas.
Args: customer_id: ID del partner (res.partner) cliente. order_lines: lista de líneas, cada una como {"product_id": , "product_uom_qty": }.
Inputs: customer_id (required), order_lines (required). Returns: object
odoo_sales_list_ordersA
Lista cotizaciones y pedidos de venta (sale.order).
Args: customer: filtra por nombre de cliente (partner). state: filtra por estado ('draft', 'sent', 'sale', 'done', 'cancel'). limit: máximo de registros a devolver (default 20).
Inputs: limit, state, customer. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 13 tools
Each tool targets a distinct domain-resource-action combination (e.g., CRM leads, sales orders, project tasks, purchase orders), so there is no meaningful overlap. Even similar list tools are clearly separated by domain prefixes like sales vs purchase.
Tool names follow a highly consistent pattern: odoo_<domain>_<verb>_<resource> (e.g., odoo_crm_create_lead, odoo_project_update_task). The only exception, odoo_ping, is a standard health-check exception and does not detract from the overall consistency.
With 13 tools covering CRM, sales, projects, inventory, and purchase, the surface is well-scoped for an Odoo integration. Each tool serves a clear purpose, and the count is neither bloated nor too thin.
Core read and create workflows are well represented across major modules, including lead management, task management, and order creation. However, there are notable gaps such as no update or delete for sales/purchase order and no project creation, which slightly limit full lifecycle coverage.
Maintenance
Related MCP Connectors
Connect your Odoo to Claude and ChatGPT: ask about sales, stock, customers and invoices.
Connect AI to Odoo ERP 14-20: search, create, update and manage records in natural language.
Odoo MCP connector for ChatGPT and Claude: ask sales, invoices and stock in plain words. Read-only.
Odoo MCP Pack — ERP/CRM via Odoo's external JSON-RPC API.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to interact with Odoo ERP systems through XML-RPC communication. Provides access to Odoo models, records, methods, and data structures for comprehensive ERP integration.2MIT
- AlicenseNot gradedqualityDmaintenanceEnables interaction with Odoo ERP systems through 17+ business tools covering sales, purchasing, inventory, and accounting operations. Supports both Claude Desktop integration and web deployment with dual transport modes.MIT
- FlicenseNot gradedqualityDmaintenanceConnects Claude Desktop to Odoo ERP via JSON-2 API for searching invoices, creating sales orders, checking customer balances, and managing webhooks.1-
- AlicenseNot gradedqualityCmaintenanceEnables Claude to interact with Odoo through 12 MCP tools covering discovery, CRUD operations, and bulk import/export via XML-RPC.MIT