Production-grade Model Context Protocol server suite connecting Claude Code, Claude Desktop, and any MCP-compatible client to Odoo 15–19 — with Bulgarian localization, 197+ tools, and a browser-based terminal that your accountants can actually use.
The project ships on two branches with different audiences and release cadences. Pick the one matching your role.
2.0 · docker :latest · :stable · :2.x.yOdoo end-users, accountants, Bulgarian SMEs, developers working with a single Odoo stack, content teams managing website and blog content.
3.0 · docker :next · :3.x.yOdoo implementation partners, OCA community contributors, SaaS MSPs running multiple client instances, integrator agencies deploying AI workflows to clients.
Click any card to see the tool family's full API, use cases, and copy-paste examples on the dedicated documentation page.
odoo_search, odoo_read, odoo_search_read, odoo_create, odoo_write, odoo_unlink, odoo_execute. Full XML-RPC / JSON-RPC coverage with live refresh bus.
odoo_fields_get, odoo_list_models, odoo_module_info, odoo_version. Inspect the schema of any model or module without filesystem access.
odoo_list_translatable_fields, odoo_get_field_translations, odoo_translate_field (simple), odoo_translate_html (extract / terms / replace). Auto-ZWSP for identical values.
odoo_website_list_snippets, list_page_snippets, add_snippet, update_snippet, remove_snippet. Swap banner backgrounds, insert CTAs, mutate blog / page HTML via xpath substitutions.
odoo_web_login, odoo_web_call, odoo_web_export, odoo_web_report, odoo_web_request. Works through Cloudflare — no XML-RPC endpoints needed.
odoo_attachment_upload, odoo_attachment_download, public_access_download, public_access_image. Full binary data pipeline including vision-based invoice OCR.
odoo_report, public_access_report_pdf, public_access_report_xlsx, public_access_report_html. Generate PDF, XLSX, HTML reports on any model.
public_access_portal_{home,orders,invoices,tickets,purchases}, public_access_shop, public_access_sitemap. Headless access to the customer portal.
odoo_fp_configure, odoo_fp_list, odoo_fp_details, odoo_fp_types, odoo_fp_remove_action. Fiscal position tax action maps tailored for НАП compliance.
ai_tokenize_record, ai_tokenize_collection, ai_search_similar, ai_list_documents, ai_collection_info. Vector embeddings per Odoo record for semantic search.
memory_read, memory_write, memory_list, memory_share, memory_pull, memory_delete. Per-user, shared, and licensed memory packs.
Gmail (search, read, send, labels), Calendar (CRUD events, suggest time), Drive (read, metadata). OAuth flow handled by MCP; credentials never leave the server.
Learn more ✈️telegram_auth, telegram_send_message, telegram_search_contacts, telegram_get_dialogs, telegram_get_messages. Full MTProto client, not just bot API.
ssh_execute, git_remote, github_api. Remote command execution with SSH agent forwarding; git operations on any cloned repo.
OCA repo management (clone, update, search, migrate, gen_icon / readme / table); Enterprise license status, module dependencies, conflict detection.
Learn more 🐳Full Portainer API — manage stacks, environments, access groups, teams, users; deploy local stacks; docker proxy for raw container operations.
Learn more 🔌odoo_connect, odoo_connections, odoo_cert_info, odoo_cert_refresh, user_connection_add, who_am_i, identify. Multi-tenant auth with TOFU cert pinning.
The MCP stack is paired with two Odoo modules that turn any instance into a fully MCP-aware, multi-tenant, billing-ready AI workstation.
Exposes MCP + Claude Terminal configuration as user preferences and company settings. Works on Odoo 16, 18 and 19 (each major series has a dedicated branch).
verify_ssl + TOFU cert pinningEnterprise billing module for hosting providers and BL Consulting tier management. Tracks per-user MCP usage, calculates bills, provisions Portainer stacks per tenant, ships licensed memory packs.
The server validates your key against your Odoo instance via XML-RPC, registers the connection under your MCP profile, and generates your terminal link. Non-secret fields are cached locally so you don't retype them.
Generate an API key in Odoo → Preferences → Account Security → New API Key. Then fill in below.