Skip to Content
​mcp_terminal

​Claude Code in Odoo · International edition

​International fork without BG-localization 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

​Runs on 5 Odoo versions — 16, 17, 18, 19, master

​Since 2026-04-25 we maintain all branches in parallel; the AI Tokenizer stack is being 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 LOCALIZATION

​For BG instances → use l10n_bg_claude_terminal

​Same feature set, integrated in the l10n-bulgaria repo alongside the rest of the 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

​A 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 + 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 files.

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

​INSTALL IN 3 MINUTES

​How to install

​1
​Clone the odoo-mcp-terminal 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 URL + API key.

​Got install questions?

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

​Book now →