Odoo MCP Server (Enhanced for AI Agents)

---

Introduction

Odoo MCP Server is a Model Context Protocol server that connects AI agents (Claude Code, Claude, ChatGPT, n8n, …) to any Odoo database, from Odoo 10 to Odoo 20.

It speaks XML-RPC to Odoo 18 and older and Odoo’s JSON-2 API to Odoo 19 and newer, picking the right one automatically. XML-RPC is deprecated in Odoo 19 and will be removed in Odoo 22. Responses are kept small and readable for language models: records are paginated, and binaries are summarised instead of sent. Long text is cut, Arabic and other non-Latin text stays as plain UTF-8, and metadata comes back as compact tables.

Odoo connections, API keys and admin accounts are all managed in a built-in web admin UI. Nothing sensitive goes in environment files.

Key features

• Dual transport: auto-detects the Odoo version and uses JSON-2 on 19+ and XML-RPC on 18 and older; it can be forced per connection.
• AI-friendly output: small defaults, paginated search, binary summaries, a 100 KB response guard and compact JSON.
• 13 tools with MCP annotations (read-only / destructive hints), including get_context, aggregate and name_search.
• Context-aware: the user, time zone and language, plus multi-company and branch control on every tool.
• Standards-compliant MCP: protocol versions 2024-11-05 to 2025-11-25, tool errors returned as isError results, structuredContent, batching and notifications.
• Web admin UI: connections with a step-by-step connection test, API keys with read-only or read-write scope, and a dashboard with per-tool response sizes.
• Secure by design: Odoo credentials are Fernet-encrypted at rest; every MCP request needs an API key; browser origins are blocked unless allowed.
• One container: two ports, one docker compose up, SQLite storage.

---

Architecture

The server runs as a single Docker container exposing two ports:

Both services share one SQLite database (data/mcp.db).