Production-grade MCP server suite v2.31.0 · preview 3.3.8 Sofia · БГ

Turn your Odoo
into a Claude
native citizen. A self-hosted Model Context Protocol server suite that connects Claude, Claude Code, and any MCP-compatible client to Odoo ERP — 19 first, and every series back to 15 — GitHub, filesystems, Kubernetes, Microsoft Teams, and a browser-based terminal — all through a unified, authenticated gateway.

Single-purpose MCP wrappers don't scale. This one is built for real production: token-based auth across all endpoints, one identity / all servers, per-user profile isolation, and multi-tenant switching between dozens of Odoo databases on the fly.

Clone the stack Read the spec → 197+ tools ref

claude · rosen@mcp-gateway · bash

LIVE

9^★

MCP servers

197⁺

MCP tools

19

Odoo · back to 15

AGPL-3

Open source

01Why this exists

Single-purpose MCP wrappers
don't scale. This one is built
for real production.

Nine specialized servers behind one authenticated gateway. Unified identity, multi-tenant by design, vector-store native. Deploy on bare metal, Docker Compose, or K3s — scale without re-authenticating.

01 / 06

Unified authentication

Token-based auth across all MCP endpoints. One identity, all servers, with per-user profile isolation persisted at the gateway.

02 / 06

Multi-tenant by design

One stack, dozens of Odoo databases. Switch connections on the fly. Each user sees only their own data, always.

03 / 06

Claude.ai connector ready

Public HTTPS endpoint with Bearer token auth. Register as a Custom Connector in Team or Enterprise — done in minutes.

04 / 06

K3s & Docker Compose

Kustomize overlays for dev and prod. Docker Compose for solo developers. Pick your scale and upgrade when ready.

05 / 06

Browser-based terminal

xterm.js + tmux + Claude Code in the browser. Themable UI (Catppuccin, Dracula, Tokyo Night+), persistent sessions, auth-integrated WebSocket.

06 / 06

Vector store native

Qdrant integration for semantic search across Odoo records. Ollama (nomic-embed-text) default for local LLM inference.

02Watch it work

Not a mockup.
A real session.

Live demonstrations on YouTube — Claude Code driving a production Odoo instance through the MCP gateway. No scripts, no cuts, no narration tricks. Real queries, real data, real results.

FEATURED · YOUTUBE

Part 1 · End-to-end MCP session▶ Watch

FEATURED DEMO

Claude driving
production Odoo
through MCP.

Natural language query → Claude plans tool calls → odoo-rpc-mcp executes → results synthesized back as answer. The kind of workflow that used to take a developer an hour.

▶ Part 1 · End-to-end MCP session ▶ Part 2 · Extended walkthrough

Subscribe to channel →

03Architecture

How the stack
fits together.

Claude connects to a unified gateway. The gateway proxies to specialized MCP servers. Each server is a Docker container with its own scope, tools, and authentication.

Claude.ai

Claude Code

Claude Desktop

IDE

Unified MCP Gateway · server.py

odoo-rpc-mcp83 native tools

ee-mcpOdoo Enterprise

oca-mcpOCA modules

github-mcpGit operations

filesystemScoped I/O

portainerDocker · K8s

teams-mcpMS Teams

claude-terminalBrowser shell

Odoo 19 · 18 · 17 · 16 · 15

Qdrant · vector DB

Ollama · local LLMs

Postgres · state · memory

04What's new

Released 2026-09-04.
2.31.0 binds a connection
to its own session.

2.31.0 Stable track · branch 2.0
First tag since 2.10.0
202 tests green

Everything below had been running on client stacks since June; this is the tag that names it.

3.3.8 Preview track · branch 3.0
A second factor on the console

All releases →

2.31.0 · session model

Per-session connections

The active Odoo connection belongs to the MCP session, not to the process. Two connected Claudes never overwrite each other’s connection — odoo_connect, identify and connection activation each write into their own slot.

2.31.0 · per principal

telegram_agent enrolment

Enrolments live next to the principal’s own data, like Telegram subscriptions. A principal without a file imports the old global one once on first read; writes never go back to it.

2.31.0 · hardened

Security audit fixes

Header debug logging off by default and redacted when on. /api/user/connections requires ownership proof and returns no keys. The OAuth flow never hands out the master token. Plus Telegram file transfer, confined to the download root.

3.3.8 · preview track

TOTP on the admin console

Enrol from the Security page: password re-challenge → QR → confirming code → eight recovery codes. Every path that issues a session goes through one door, so an unscanned QR cannot lock anyone out. Preceded by 3.3.6, which put PKCE S256 and an authenticated /metrics on the OAuth surface.

05Two parallel branches

Which track
is yours?

The project ships on two branches with different audiences and release cadences. Pick the one matching your role.

Production stable

Track 2.x
End Users

branch 2.0 · v2.31.0 · docker :2.x.y

Odoo 19 end-users, accountants, Bulgarian SMEs, developers working with a single Odoo stack, content teams managing website and blog content. Every series back to 15 is supported.

All 197+ MCP tools for day-to-day Odoo work
Multi-language field management (auto-ZWSP)
Website snippet management (banners, CTAs)
Bulgaria localization (НАП, VAT, Intrastat)
AI tokenizer (Qdrant + Ollama)
Memory system (shared / user / licensed)

Preview · 3.x in development

Track 3.x
Integrators

branch 3.0 · v3.3.8 · docker :3.x.y

Odoo implementation partners, OCA community contributors, SaaS MSPs running multiple client instances, integrator agencies deploying AI workflows.

Admin lifecycle (install / upgrade / health-check)
Industry skill packs (MFG / Retail / Services)
One-click demo builder (< 5 min)
Module dev toolkit (scaffold / lint / test)
Per-tenant Portainer provisioning
AES-256 encrypted config export

06Odoo-side integration

Companion Odoo modules.

The MCP stack pairs with two Odoo modules that turn any instance into a fully MCP-aware, multi-tenant, billing-ready AI workstation.

ODOO ↔ MCP INTEGRATION

l10n_bg_claude_terminal

LGPL-3 · FREE

Exposes MCP + Claude Terminal configuration as user preferences and company settings. Works on Odoo 16, 18 and 19 — each major series on a dedicated branch.

Per-user MCP endpoint + Bearer token
Odoo RPC with verify_ssl + TOFU cert pinning
18 terminal themes + live refresh bus
Test Connections + Save to MCP actions

Odoo 18 · 18.0.1.28.0 Odoo 19 · 19.0.1.24.0 Odoo 16

SAAS BILLING · PROVISIONING

l10n_bg_ai_billing

OPL-1 · PAID

Enterprise billing module for hosting providers and tier management. Tracks per-user MCP usage, calculates bills, provisions Portainer stacks per tenant.

8 models: bundle / tenant / usage / invoice / skills
Bundle pricing €49–599, millicents precision
Portainer client + AES-256 ZIP export
BG Trade Registry + sale.order auto-provision

Odoo 19 · 19.0.1.3.0

07All 197+ tools

Every tool
Claude can call.

Native Odoo RPC tools come from odoo-rpc-mcp. Proxied infrastructure tools are exposed through the unified gateway from portainer-mcp, github-mcp, oca-mcp, ee-mcp, filesystem-mcp. All authenticated via the same Bearer token.

⇅14

CRUD & Search

odoo_searchodoo_readodoo_createodoo_writeodoo_unlinkodoo_execute+8

Natural language queries, bulk imports, workflow automation (action_post, action_confirm).

🔍4

Introspection

fields_getlist_modelsmodule_infoversion

"Which fields are translate?" "Where is this module installed?"

NEW 2.10

🌐4

Translations

list_translatable_fieldsget_field_translationstranslate_fieldtranslate_html

Translate blog posts, product descriptions, website pages. 3 modes + auto-ZWSP fix.

NEW 2.10

🧱5

Website Snippets

list_snippetslist_page_snippetsadd_snippetupdate_snippetremove_snippet

Swap banner backgrounds, insert CTAs, mutate blog/page HTML via xpath + CSS-property substitutions.

🔐7

Web Session

web_loginweb_callweb_readweb_exportweb_report+2

Cookie-based HTTP. Works through Cloudflare — no XML-RPC endpoints needed.

📎4

Attachments

attachment_uploaddownloadpublic_access_downloadimage

Binary pipeline including vision-based invoice OCR.

📊6

Reporting

odoo_reportreport_pdfreport_xlsxreport_htmlexport_csv+1

PDF invoices, XLSX exports, HTML dashboards — all headless.

🌍8

Portal & Public

portal_homeordersinvoicespurchasesticketsshopsitemapbarcode

Headless customer portal — orders, invoices, tickets, shop.

🇧🇬5

Bulgaria Localization

fp_listdetailstypesconfigureremove_action

Fiscal position tax action maps for НАП: protocols Art. 117, customs declarations, private usage.

🧠5

AI Tokenizer

ai_tokenize_recordai_tokenize_collectionai_search_similarai_list_documentscollection_info

Qdrant vector embeddings per record. Ollama (nomic-embed-text) default. Semantic search.

📚6

Memory System

memory_readwritelistsharepulldelete

Three scopes: per-user, shared team, licensed memory packs. Merged on session start.

🔌12

Connections & Auth

odoo_connectconnectionscert_infocert_refreshuser_connection_*who_am_iidentify

Multi-tenant aliases, TOFU cert pinning for self-signed, per-user profile isolation.

📧11

Google Workspace

gmail_searchgmail_sendcalendar_eventsdrive_readdrive_metadata+6

Gmail · Calendar · Drive over OAuth. Email triage, scheduling, Drive file lookup — all from Claude.

✈️7

Telegram

telegram_configureauthsearch_contactsget_dialogsget_messagessend_message

Full MTProto client — user-account, not bot-API. Send / read / DM / groups / channels.

🖥️3

SSH & Git

ssh_executegit_remotegithub_api

Remote command execution with SSH agent forwarding; git metadata and GitHub API escape hatch.

📦25

OCA & Enterprise

oca_searchclone_repomigrategen_readmeee_dependsoca_conflicts+19

Clone and maintain the whole OCA constellation; EE module selection + conflict detection.

🐳30

Portainer & Docker

stacks_listcreateupdateredeployenvironmentsteamsusersk8sProxy+22

Provision per-tenant MCP stacks, scale k8s, raw Docker API when needed.

🐙36

GitHub

code_searchissuesprsrepo_treecommitsactions_runsjob_logs+29

Powered by the official ghcr.io/github/github-mcp-server. Full REST passthrough.

📁15

Filesystem

read_filewrite_fileedit_filemove_filecreate_directorydirectory_tree+9

Sandboxed to /repos — safe AI agent filesystem operations.

08Who it's for

Four audiences.
One stack.

⟨/⟩

Odoo Developers

Live module development with Claude on your running instance
RPC-based module deployment — no filesystem access needed
Multi-environment workflows — dev, staging, prod in one session
OCA contribution flows — clone, test, PR through Claude

✦

Odoo Consultants

Multiple client databases from one authenticated session
Per-client memory — Claude remembers context per customer
Shared team knowledge via memory_share
Bulgaria localization — fiscal positions, VAT, НАП tools

◉

Business Users

Natural language queries over real Odoo records
Invoice extraction via vision LLMs into account.move
Semantic search — find similar contracts, tickets, records
Email & calendar coordination across Odoo, Gmail, Teams

◆

Platform Operators

Multi-tenant hosting — isolated endpoints per client
Billing integration — usage tracking via Cloudflare AI Gateway
White-label claude-terminal for your customers
Kubernetes scaling — replicas scale independently by load

09Get started

Three ways
to deploy.

01 / DOCKER

Docker Compose

Local development · Solo developer

# Clone & configure
$ git clone https://github.com/
  rosenvladimirov/odoo-claude-mcp.git
$ cd odoo-claude-mcp
$ cp .env.example .env
$ nano .env

# Start the stack
$ docker compose up -d
✓ 8 services running

02 / INSTALL

Install script

Quickest path · Any OS

# Linux / macOS
$ curl -fsSL raw.../install.sh | bash

# Windows (PowerShell admin)
> iwr -useb raw.../install.ps1 | iex

✓ Docker containers pulled
✓ Env configured interactively
✓ Stack up on localhost:8084

03 / K3S

Kubernetes

Production · Multi-tenant SaaS

# Kustomize overlays in k3s/
$ cd k3s/overlays/prod
$ cp .env.example .env
$ cp ../../base/secrets.example.yaml
  secrets.yaml

# Edit secrets, then deploy
$ kubectl apply -k .
✓ Deployed with cert-manager
✓ Ingress + TLS ready

10Bulgaria localization

First-class
БГ support.

Maintained by the OCA l10n-bulgaria maintainer. Bulgarian-specific features are not an afterthought — they're native. The only Odoo partner in CEE with direct НАП reporting integration.

НАП integrationFiscal positions, VAT tax maps, audit reports — protocols Art. 117 ready.
l10n_bg_* familyComplete ecosystem support, maintained on the OCA organization.
Образец 1Monthly НАП declaration — compliant with Наредба № Н-13/2019.
Partner IDUIC / ЕИК, legal forms, NACE codes wired into partner model.
TransliterationBG ⇄ EN ⇄ GR mixin for partner names. Quiet, consistent.
Справка-декларацияНАП-flavored SQL-engine audit reports, pre-configured.

11Maintained by

Rosen Vladimirov.

OCA l10n-bulgaria maintainer. 10+ years specializing in Odoo implementations for Bulgarian businesses. Executing company Terraros Commerce Ltd.

vladimirov.rosen@gmail.com @rosenvladimirov YouTube github.com/rosenvladimirov

Single-purpose MCP wrappersdon't scale. This one is builtfor real production.