Skip to Content
​mcp_terminal

​Claude Code in Odoo · International edition

International fork without BG localisation strings. Same functionality as l10n_bg_claude_terminal, same 5 branches (16/17/18/19/master), mutually exclusive with the BG sibling.

​GitHub · 19.0 ​Install help

VERSION SUPPORT

Works on 5 Odoo versions — 16, 17, 18, 19, master

As of 2026-04-25 we maintain all branches in parallel; the AI Tokenizer stack is backported all the way to 16.

​Odoo 16

​v16.0.1.28.0
AI Tokenizer (backport)

​Source →
​Odoo 17

v17.0.1.30.0
backport from 18

​Source →
​Odoo 18

​v18.0.1.30.0
stable

​Source →
​Odoo 19

​v19.0.1.28.0
latest stable

​Source →
​master

​v20.0.1.28.0
upcoming 20.0

​Source →

BULGARIAN LOCALISATION

For BG instances → use l10n_bg_claude_terminal

Same feature set + integrated in the l10n-bulgaria repo alongside the other BG modules (NRA export, VAT, fiscal positions). Mutually exclusive with mcp_terminal.

View page → ​l10n-bulgaria repo

GUI TOOLS

What the module adds to the UI

​⚙️ User Preferences

New tab in User Preferences with groups:

  • Claude Terminal — URL + API key + theme (18 themes)
  • ​Odoo RPC Connector — URL, DB, protocol, verify_ssl (TOFU)
  • ​Web Session — alternative auth for Cloudflare-protected instances
  • ​MCP Server — endpoint + Bearer token
  • ​Telegram / Viber MCP — MTProto + bot credentials
🤖 AI button in chatter

A "Claude" button appears on every list and form view. Clicking it opens the Claude Code terminal with:

  • Pre-loaded record context (model + res_id)
  • API key auth (no login prompts)
  • Automatic memory_pull() of shared knowledge
  • ​Live refresh bus — Claude update → UI flash update
✅ Test Connections button

One click → sticky notifications chain with results from 5 connection tests:

  • ​Odoo RPC (XML-RPC / JSON-RPC / Web Session fallback)
  • ​MCP Server (/health)
  • ​Web Session (/web/session/authenticate)
  • ​Qdrant (AI Tokenizer)
  • ​Ollama (embeddings)
💾 Save to MCP button

Registers the user's Odoo alias in the central MCP connection store without manually editing any files.

Calls POST /api/user/connections with JSON: alias, URL, DB, user, API key, verify_ssl.

3-MINUTE INSTALLATION

How to install

1
Clone the repo
​# Odoo 19
$ git clone -b 19.0 \
  https://github.com/rosenvladimirov/odoo-mcp-terminal.git
2
Add to addons_path
​# odoo.conf
addons_path = /opt/odoo/addons,\
  /opt/odoo/rv/odoo-mcp-terminal
3
​Apps → Install

Search for "MCP Terminal" in Apps. After install → Preferences → Claude Terminal tab. Fill in the URL + API key.

Questions during installation?

Free 30-minute consultation — we help with setup, configuration, and your first use case.

Book a slot →