RebundleRebundle Stack
Claude Code Hub

Odoo

Tu Odoo, desde Claude Code

Pregúntale a Claude por tu pipeline, tus facturas o tu stock en Odoo. Pega un prompt y Claude se conecta al servidor MCP del propio Odoo, empieza en solo lectura y solo crea o cambia algo cuando tú lo digas.

Mira primero tu plan: Odoo solo deja conectar programas externos en el plan Custom. Con One App Free o Standard no hay acceso por API ni MCP, y Claude solo puede trabajar con listas que exportes (Excel o CSV). El servidor MCP forma parte de la app IA de Odoo (Odoo 20, u Odoo Online desde la versión 19.4), e instalar esa app en Standard te pasa a Custom: Claude no instalará nada ni cambiará tu plan sin tu OK. Ninguna clave pasa por el chat, y Claude te enseña cada borrador antes de crear o cambiar un registro.
1

Abre Claude Code

Tú haces esto
  1. 1Abre Claude Desktop
  2. 2Haz clic en la pestaña Claude Code
  3. 3Elige una carpeta vacía, por ejemplo Documentos/odoo-claude
2

Pega este prompt

Claude Code

Claude te preguntará por tu Odoo (plan, versión, dónde está alojado), elegirá la vía que encaja, esperará a que apruebes el acceso en la web de tu Odoo y te enseñará tus oportunidades abiertas y tus facturas pendientes de cobro. Solo tienes que seguirle.

dile esto a claude
Quiero conectar mi Odoo a Claude Code para consultar mi CRM, ventas, facturación, inventario o contactos y, cuando yo lo apruebe, preparar borradores. No soy técnico: guíame paso a paso, un paso cada vez, y espera a que te confirme antes de seguir. CONTEXTO PARA TI - Acceso según el plan (doc oficial: https://www.odoo.com/documentation/20.0/developer/reference/external_api.html y la FAQ de https://www.odoo.com/pricing): conectar un programa externo a Odoo solo está permitido en el plan Custom; en One App Free y Standard no hay acceso a la API externa. Si mi plan no es Custom, no intentes conectarte: trabajaremos con exportaciones (abajo) y te digo si quiero hablar con Odoo para cambiar de plan. - Vía recomendada, el servidor MCP oficial de Odoo (doc: https://www.odoo.com/documentation/20.0/applications/productivity/ai/mcp_server.html). Forma parte de la app IA de Odoo, está documentado para Odoo 20 y para Odoo Online desde la versión 19.4, y vive en la URL de mi base de datos más /mcp (por ejemplo, https://miempresa.odoo.com/mcp). Instalar la app IA en una base con plan Standard dispara el paso al plan Custom (https://www.odoo.com/documentation/20.0/applications/productivity/ai.html): no la instales ni cambies ningún ajuste que afecte al plan sin mi OK explícito. - Odoo recomienda conectarse con OAuth: en Claude Code, claude mcp add --transport http odoo <URL de mi Odoo>/mcp, mejor con --scope user para que funcione desde cualquier carpeta; luego claude mcp list para ver el estado. Se abre la página de inicio de sesión de Odoo y después «Grant Access», donde elijo cuánto tiempo dura el acceso y pulso Allow. OAuth es solo para usuarios internos (no de portal). Solo pueden pedir acceso los clientes aprobados, en Ajustes → Integraciones → MCP OAuth: si Odoo rechaza a Claude Code, dime que lo revise un administrador ahí, siguiendo la doc oficial. No me propongas activar el registro dinámico de clientes (DCR) para salir del paso: deja que cualquier aplicación se registre. - Herramientas (lista oficial: https://www.odoo.com/documentation/20.0/applications/productivity/ai/mcp_server/mcp_tools.html): por defecto Odoo solo expone las de lectura (Get Models, Get Fields, Search, Read group y la de contexto inicial). Las de escritura (Create Records, Update Records) y el resto las tiene que exponer un administrador a mano, con el modo desarrollador, en Ajustes → Técnico → Acciones de servidor, marcando «Available in MCP». No me pidas exponer las de escritura hasta que quiera crear o cambiar algo. La casilla «Readonly Tool» solo le dice al cliente que la herramienta es segura; no es un permiso. - Cada conexión aparece como una API key en Mis preferencias → pestaña Seguridad de mi usuario; para revocar el acceso, se borra esa clave. Odoo comprueba siempre los permisos de mi usuario: Claude nunca ve ni hace más que yo. - Alternativa, si mi Odoo es la versión 19 (o no tiene la app IA) y el plan lo permite: la API JSON-2 (nueva en la 19.0; doc: https://www.odoo.com/documentation/20.0/developer/reference/external_api.html). Peticiones POST a <URL>/json/2/<modelo>/<método> (por ejemplo, /json/2/res.partner/search_read) con la cabecera Authorization: bearer <clave> y, si hace falta, X-Odoo-Database con el nombre de la base. La clave se crea en Preferencias → Seguridad de la cuenta → Nueva clave API (en Odoo 20, Mis preferencias → Seguridad → Crear clave API); se ve una sola vez y dura como mucho tres meses. La clave tiene todos los permisos de mi usuario, sin modo de solo lectura: para algo continuo, Odoo recomienda un usuario dedicado con los permisos mínimos. Cada llamada es su propia transacción y se guarda al momento: no hay deshacer. - XML-RPC y JSON-RPC (/xmlrpc, /jsonrpc) están obsoletos desde la 19.0 y Odoo los retira en Odoo Online 21.1 (invierno de 2027) y en Odoo 22 (otoño de 2028). Úsalos solo si mi versión es anterior a la 19, y avísame de que caducan. - Sin API (One App Free o Standard): en cualquier vista de lista, selecciono los registros → Acciones → Exportar → Excel (.xlsx) o CSV (doc: https://www.odoo.com/documentation/20.0/applications/essentials/export_import_data.html). Tú lees el fichero de esta carpeta. Si una exportación es muy grande, mejor por tandas. QUÉ QUIERO QUE HAGAS 1. ENTENDER: pregúntame, de una en una y con opciones para elegir: qué quiero (CRM y pipeline, ventas y facturas, inventario, contactos, o también preparar borradores); dónde está mi Odoo (Odoo Online, la web acaba en odoo.com; Odoo.sh; o un servidor propio) y su URL; qué plan tengo (One App Free, Standard, Custom o no lo sé); qué versión (si no lo sé, compruébalo tú en la doc o en mi Odoo, sin cambiar nada); y si mi usuario es administrador. 2. REVISAR: comprueba tú mismo si Claude Code ya tiene el servidor de Odoo (claude mcp list o sus herramientas). Si ya está y responde, salta al paso 5. 3. RECOMENDAR: dime en dos frases qué vía encaja. Con plan Custom y Odoo 20 (u Online 19.4 o posterior), el MCP oficial con OAuth. Con plan Custom y Odoo 19, la API JSON-2. Sin plan Custom, exportar listas. Nunca un servidor MCP de la comunidad ni un módulo de terceros de la tienda de apps de Odoo. 4. CONECTAR: con el MCP, si la app IA no está instalada, dímelo y para: decidir instalarla es cosa mía (y del administrador), por el plan. Si está, ejecuta tú el comando de arriba (con --scope user), pidiéndome permiso antes. Se abrirá mi Odoo en el navegador: antes de que apruebe, explícame en una frase qué estoy dando, que elija una duración corta y que puedo rechazarlo. Cuando te diga «OK», comprueba que ves sus herramientas; si no, dime cómo reiniciar Claude Code. Si elegimos la API: guíame para crear la clave en mi Odoo con una caducidad corta; cuando la haya copiado y te diga «OK», léela tú del portapapeles (pbpaste en Mac; Get-Clipboard de PowerShell en Windows) y guárdala directamente como variable de entorno de usuario ODOO_API_KEY (en Mac, una línea export en ~/.zshrc; en Windows, [Environment]::SetEnvironmentVariable con ámbito User), sin mostrarla, repetirla ni escribirla en el chat. Comprueba solo que no está vacía y después vacía el portapapeles. Si exportamos: dime qué lista exportar y dónde dejar el fichero. 5. PROBAR (solo lectura): dime a qué base de datos y con qué usuario estás conectado y enséñame en tablas cortas las oportunidades abiertas por etapa, las facturas pendientes de cobro (cliente, fecha, importe) y los últimos 5 contactos. Si solo tengo lo que el plan o mis permisos dejan ver, dímelo. 6. RECORDAR: crea una skill personal con cómo te conectas a mi Odoo (MCP, API o exportación), la URL de la base, mi plan y versión, la fecha en que caduca el acceso o la clave (para avisarme antes), lo que suelo pedirte y las reglas de abajo. Así la próxima vez me basta con preguntarte. Reglas: trabaja en solo lectura salvo que yo pida otra cosa. No crees, edites, confirmes, envíes ni borres oportunidades, pedidos, facturas, contactos ni productos salvo que yo lo pida de forma explícita, y antes enséñame el borrador completo y espera mi OK. Una factura validada tiene efectos fiscales: si hay que corregir una, pregúntame antes. Antes de sobrescribir cualquier dato, guarda el original en un fichero de esta carpeta para poder volver atrás. No instales apps, no expongas herramientas de escritura ni cambies ajustes de Odoo sin mi OK, y nunca nada que cambie mi plan. Pide solo lo que haga falta: nada de recorrer toda la base de golpe. Nunca me pidas una clave en el chat. Si algo falla, explícamelo en lenguaje sencillo antes de intentar arreglarlo. CÓMO TRABAJAR CONMIGO - Explícame cada paso como a un niño de 10 años: frases cortas, sin jerga y, si usas una palabra técnica, dime en una línea qué es. Si te digo que soy técnico, ve al grano. - Cuando tengas que preguntarme algo, hazlo de una pregunta en una y con opciones para elegir (usa la herramienta de preguntas con opciones si la tienes), con una línea que explique cada opción. - Si hay que instalar algo, dime en una línea qué es y para qué sirve, y ofrécete a instalarlo tú con mi permiso. Si algo falla, cuéntame en palabras sencillas qué ha pasado y cuál es el siguiente intento, antes de probarlo. - Lo que te cuento arriba puede haberse quedado viejo. Antes de empezar, comprueba en la documentación oficial que sigue vigente; si algo no coincide, manda la documentación y dime qué ha cambiado. - Si tienes navegador (el navegador integrado de la app de Claude o Claude in Chrome), hazlo tú todo lo que puedas en vez de mandarme a una web: ábrela tú, navega hasta la pantalla exacta, rellena lo que no sea secreto y léeme lo que haga falta. Si arriba pone que yo vaya a una página o pulse algo, tómalo como lo que hay que conseguir y hazlo tú con el navegador. Pídeme a mí, de un paso en uno, solo lo que no puedes hacer: iniciar sesión, aprobar permisos, pagar o copiar una clave; tú no escribes contraseñas ni claves en ninguna web. Si no tienes navegador, entonces guíame con instrucciones. - Si hacen falta claves o algo más para conectarte (scripts, configuración), guárdalo en un sitio fijo de mi usuario, fuera de esta carpeta y de cualquier repositorio, que solo yo pueda leer. Nunca en el chat ni dentro de una skill. - La skill de RECORDAR, hazla personal (que funcione desde cualquier carpeta) y apunta en ella: cómo conectarte, con qué cuenta o usuario, dónde están las claves (el sitio, nunca el valor), qué suelo pedirte, las reglas de arriba y la fecha en que comprobaste la documentación. Si algo deja de funcionar porque el servicio cambió, mira la documentación, arréglalo y actualiza la skill. - Mis preferencias y lo que haya fallado van en un LEARNINGS.md aparte, en la misma carpeta de esa skill (una línea por aprendizaje, con fecha y el porqué). El primer paso de la skill es leerlo y aplicarlo. Para que nunca se te olvide proponer aprendizajes nuevos al terminar, añade al frontmatter de su SKILL.md este hook, cambiando <nombre-de-la-skill> por su nombre (inyecta un recordatorio una vez por uso; no lo cambies por un bloqueo, que entra en bucle): hooks: Stop: - hooks: - type: command once: true command: | grep -q '"stop_hook_active":true' && exit 0 echo '{"hookSpecificOutput":{"hookEventName":"Stop","additionalContext":"Antes de terminar: si en este uso de la skill <nombre-de-la-skill> el usuario corrigió algo, algo falló o mostró una preferencia, propón de 0 a 3 aprendizajes para su LEARNINGS.md (fecha, una línea y el porqué), enséñalos y pide OK antes de escribirlos. Si ya propusiste aprendizajes en este turno, no los repitas. Si no hay nada que aprender, termina sin añadir nada."}}'

Después, prueba con estos

Cuando Claude confirme que está conectado, pídele cosas como:

Enséñame mis oportunidades abiertas por etapa y el valor total de cada una

¿Cuánto facturamos el trimestre pasado comparado con este?

¿Qué facturas tengo pendientes de cobro y desde cuándo?

Prepárame los contactos de estos cinco leads y enséñamelos antes de crearlos

Odoo en detalle

El servidor MCP de Odoo, la alternativa por API, qué planes lo permiten y a qué prestar atención.

Odoo incluye su propio servidor MCP en su app IA: documentado para Odoo 20 (publicado en septiembre de 2026) y para Odoo Online desde la versión 19.4, en la URL de tu base de datos más /mcp. Odoo recomienda conectarse con OAuth: inicias sesión en tu Odoo, eliges cuánto dura el acceso y ninguna clave pasa por el chat. Por defecto solo expone herramientas de lectura; para crear o cambiar registros, un administrador tiene que exponer antes esas herramientas.

La pega es el plan: el acceso por API externa solo está en el plan Custom, no en One App Free ni en Standard, e instalar la app IA en Standard pasa la base de datos a Custom. En Odoo 19, la alternativa es la API JSON-2 con una API key. Sin plan Custom, Claude puede trabajar igualmente con las listas que exportes a Excel o CSV. Los servidores MCP de la comunidad y los módulos de terceros no entran aquí: con el servidor del propio Odoo disponible, no hay motivo para darle tus datos a un tercero.

EnlacesServidor MCP de OdooLista de herramientas del MCPAPI JSON-2 (API externa)Planes de OdooExportar datos de OdooRevisado: noviembre 2026

Por qué con Claude Code

Preguntas sobre tu negocio

«Oportunidades abiertas por etapa», «cuánto facturamos el trimestre pasado», «qué productos no tienen previsión»: Claude lee Odoo con los permisos de tu usuario y responde con una tabla corta.

Borradores, no sorpresas

Las herramientas de escritura vienen apagadas. Cuando las actives, el prompt obliga a Claude a enseñarte el borrador completo y esperar tu OK: una escritura se guarda al momento, y una factura validada tiene efectos fiscales.

Junto a tus otras herramientas

Si tu cuenta de empresa está en Revolut, Claude puede mirar el banco y Odoo en la misma conversación, por ejemplo para ver qué cobros cuadran con qué facturas.

Ejemplos

Lectura, por defecto

De serie, el MCP expone Get Models, Get Fields, Search, Read group y el contexto inicial (tu usuario, empresa y zona horaria). Con ellas Claude consulta cualquier modelo que tu usuario pueda ver: CRM, ventas, facturas, inventario, contactos.

Escritura y más, si la expones

Create Records y Update Records, abrir vistas de lista, kanban, pivote o gráfico en Odoo, y editar la web. Las expone un administrador en Ajustes → Técnico → Acciones de servidor, marcando «Available in MCP». La lista completa, en la doc de Odoo.

Cómo añadirlo

Recomendado

MCP de Odoo en Claude Code

Oficial y con OAuth. Plan Custom, app IA instalada, Odoo 20 u Odoo Online 19.4 o posterior.

  1. 1Añade el servidor con la URL de tu base de datos (Claude puede ejecutarlo por ti). Con --scope user queda disponible desde cualquier carpeta; claude mcp list enseña su estado.
  2. 2Se abre tu Odoo en el navegador: inicia sesión, elige cuánto dura el acceso en la página Grant Access y pulsa Allow. Solo pueden pedir acceso los clientes aprobados en Ajustes → Integraciones → MCP OAuth; si Odoo rechaza a Claude Code, lo revisa ahí un administrador.
claude mcp add --transport http odoo https://mycompany.odoo.com/mcp --scope user
Alternativa

API JSON-2 con una API key

Para Odoo 19 o sin la app IA. Solo plan Custom. La clave nunca pasa por el chat.

  1. 1En Odoo: Preferencias → Seguridad de la cuenta → Nueva clave API (en Odoo 20 aparece como Mis preferencias → Seguridad → Crear clave API). Se ve una sola vez y dura como mucho tres meses. Tiene todos los permisos de tu usuario: para un uso continuo, Odoo recomienda un usuario dedicado con los permisos mínimos.
  2. 2Claude lee la clave de tu portapapeles, la guarda como variable de entorno de usuario sin mostrarla y llama a /json/2/<modelo>/<método> con Authorization: bearer. Detalle en la doc de la API JSON-2 de Odoo.
curl -X POST https://mycompany.odoo.com/json/2/res.partner/search_read -H "Authorization: bearer $ODOO_API_KEY" -H "Content-Type: application/json" -d '{"domain": [["is_company", "=", true]], "fields": ["name"]}'
Sin API

Exportar listas a Excel o CSV

Para One App Free y Standard, que no tienen acceso por API. Solo lectura por definición.

  1. 1En cualquier vista de lista, selecciona los registros y pulsa Acciones → Exportar, elige los campos y el formato: Excel (.xlsx) o CSV. Guarda el fichero en la carpeta donde trabaja Claude Code.
  2. 2Para un informe que repites, guarda la selección de campos como plantilla de exportación. Las exportaciones muy grandes pueden agotar el tiempo: hazlas por tandas.

Qué cuesta

Tu plan de OdooEl acceso por API y MCP necesita el plan Custom; One App Free y Standard no lo tienen. Los precios por usuario cambian según el país: mira la página de precios de Odoo.
La app IAEl servidor MCP viene con ella. Instalarla en una base Standard la pasa a Custom automáticamente. Las funciones de IA del propio Odoo consumen créditos IAP; la doc no dice lo mismo de las llamadas por MCP.
El coste realUn registro cambiado o una factura validada por error: cada escritura se guarda al momento, sin deshacer. Por eso el prompt empieza en solo lectura y enseña cada borrador antes.

Bueno saber

  • XML-RPC y JSON-RPC (/xmlrpc, /jsonrpc) están obsoletos desde Odoo 19 y se retiran en Odoo Online 21.1 (invierno de 2027) y en Odoo 22 (otoño de 2028). Solo para versiones anteriores a la 19.
  • Cada conexión por MCP aparece como una API key en Mis preferencias → Seguridad. Para revocar el acceso, bórrala ahí. Las API keys duran como mucho tres meses: apunta la fecha para que no te pille por sorpresa.
  • La casilla «Readonly Tool» de una herramienta solo le dice a Claude que puede usarla sin preguntar; no bloquea nada. Lo que limita a Claude es qué herramientas están expuestas y los permisos de tu usuario.
  • La doc de Odoo también describe conectar el MCP con una API key a través de Node.js; está pensado para usuarios de portal, que no pueden usar OAuth. Usa OAuth: no hay clave que guardar ni pegar.
  • Usa el servidor MCP del propio Odoo, no uno de la comunidad ni un módulo de la tienda de apps de Odoo: el oficial lo hace Odoo, se autoriza en tu propio Odoo y tus claves se quedan fuera del chat.

Rebundle · 2026