Skip to main content
Glama
odoo-mcp-server

odoo-mcp-server

by JayLeo44

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/common y /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

  1. Copia el archivo de ejemplo:

    cp .env.example .env
  2. Completa .env con 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_aqui

    La 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_password

    Deja ODOO_API_KEY vací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_KEY tiene prioridad.

    Instancia local con certificado self-signed o sin HTTPS real: revisa también ODOO_VERIFY_SSL y la nota sobre http:// vs https:// en Troubleshooting — es el error más común al conectar contra una instancia local.

  3. .env ya 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.server

Desde 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

odoo_crm_list_leads

Lista leads/oportunidades, con filtros por etapa, vendedor y tipo.

odoo_crm_create_lead

Crea un lead u oportunidad nuevo.

odoo_crm_update_lead

Actualiza campos de un lead existente.

odoo_sales_list_orders

Lista cotizaciones/pedidos de venta.

odoo_sales_create_order

Crea una cotización con líneas de producto.

Proyectos y Tareas

Tool

Descripción

odoo_project_list_projects

Lista proyectos.

odoo_project_list_tasks

Lista tareas, con filtros por proyecto, responsable y etapa.

odoo_project_create_task

Crea una tarea dentro de un proyecto.

odoo_project_update_task

Actualiza una tarea (ej. cambiar de etapa/kanban).

odoo_project_post_message

Publica un mensaje o nota en el chatter de una tarea. Soporta mention_partner_ids para etiquetar/notificar contactos.

odoo_project_read_messages

Lee los mensajes y notas del chatter de una tarea (para revisar lo publicado antes de sumar más).

odoo_message_delete

Elimina un mensaje del chatter por ID (para corregir publicaciones).

odoo_search_partner

Busca contactos/usuarios (res.partner) por nombre, para usarlos como mention_partner_ids.

odoo_timesheet_create

Registra una línea de hoja de horas (account.analytic.line) sobre una tarea.

Inventario y Compras

Tool

Descripción

odoo_inventory_list_products

Lista productos y su stock disponible.

odoo_purchase_list_orders

Lista órdenes de compra.

odoo_purchase_create_order

Crea una orden de compra con líneas.

General

Tool

Descripción

odoo_ping

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.

  • .env nunca 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/common y /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

  1. Copia el archivo de ejemplo:

    cp .env.example .env
  2. Completa .env con 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_aqui

    La 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_password

    Deja ODOO_API_KEY vací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_KEY tiene prioridad.

    Instancia local con certificado self-signed o sin HTTPS real: revisa también ODOO_VERIFY_SSL y la nota sobre http:// vs https:// en Troubleshooting — es el error más común al conectar contra una instancia local.

  3. .env ya 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.server

Desde 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

odoo_crm_list_leads

Lista leads/oportunidades, con filtros por etapa, vendedor y tipo.

odoo_crm_create_lead

Crea un lead u oportunidad nuevo.

odoo_crm_update_lead

Actualiza campos de un lead existente.

odoo_sales_list_orders

Lista cotizaciones/pedidos de venta.

odoo_sales_create_order

Crea una cotización con líneas de producto.

Proyectos y Tareas

Tool

Descripción

odoo_project_list_projects

Lista proyectos.

odoo_project_list_tasks

Lista tareas, con filtros por proyecto, responsable y etapa.

odoo_project_create_task

Crea una tarea dentro de un proyecto.

odoo_project_update_task

Actualiza una tarea (ej. cambiar de etapa/kanban).

odoo_project_post_message

Publica un mensaje o nota en el chatter (mail.thread) de una tarea.

odoo_message_delete

Elimina un mensaje del chatter por ID (para corregir publicaciones).

odoo_timesheet_create

Registra una línea de hoja de horas (account.analytic.line) sobre una tarea.

Inventario y Compras

Tool

Descripción

odoo_inventory_list_products

Lista productos y su stock disponible.

odoo_purchase_list_orders

Lista órdenes de compra.

odoo_purchase_create_order

Crea una orden de compra con líneas.

General

Tool

Descripción

odoo_ping

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.

  • .env nunca debe subirse a git ni compartirse.

Licencia

MIT

Available Tools

13 tools
odoo_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

    A4/5.0

    Scored across 13 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivitySlowing
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables 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.
      2
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables 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
    • F
      license
      Not graded
      quality
      D
      maintenance
      Connects Claude Desktop to Odoo ERP via JSON-2 API for searching invoices, creating sales orders, checking customer balances, and managing webhooks.
      1
      -
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables Claude to interact with Odoo through 12 MCP tools covering discovery, CRUD operations, and bulk import/export via XML-RPC.
      MIT