| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
Discuss (mail)
|
| Lines of code | 3716 |
| Technical Name |
odoo_mcp_manager |
| License | LGPL-3 |
| Website | https://www.cybrosys.com |
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
Discuss (mail)
|
| Lines of code | 3716 |
| Technical Name |
odoo_mcp_manager |
| License | LGPL-3 |
| Website | https://www.cybrosys.com |
Connect Claude Desktop, Cursor, and other AI assistants to your Odoo business data through the Model Context Protocol
Odoo MCP Gateway
Odoo MCP Gateway is a turnkey solution that exposes your Odoo database as a live data source for AI assistants. Connect Claude Desktop, Claude Code CLI, claude.ai, OpenAI Codex, or your own chat bots via Telegram, WhatsApp, Discord, and a Web Widget — all secured by per-user API keys and governed by a configurable tool framework.
Key Highlights
Full MCP Server Implementation
Multi-Provider AI Support (OpenAI, Anthropic, Gemini)
Bot Channels: Telegram, WhatsApp & Web Widget
AI Hub Dashboard & Execution Tracking
Community & Enterprise Support
Ready to give your AI assistants live access to your Odoo data?
Connect now and unlock the power of MCP!
AI Hub Dashboard — Your Central Control Panel
Navigate to MCP Gateway → Dashboard to view the MCP server status, active providers, tool statistics, and quick-access buttons for generating API keys and testing tools — all from a single screen.
AI Tools — Define & Manage Callable Actions for AI Assistants
Manage all AI-callable actions from MCP Gateway → Configuration → AI Tools. Each tool supports built-in ORM operations, decorated Odoo methods, or custom Python snippets, with configurable provider, model, and consent settings per tool.
MCP Resources — Expose Odoo Models to AI Clients
The Odoo MCP Gateway provides pre-configured access to core Odoo models for AI assistants, with the flexibility to enable, disable, or add additional models based on project requirements.
Configure AI Providers — OpenAI, Anthropic, Gemini & More
Go to MCP Gateway → Configuration → Providers → New. Enter your provider name (e.g. OpenAI, Anthropic, Google Gemini, or Ollama), paste your API key, and set a priority. Multiple providers can be active simultaneously — the gateway picks the highest-priority one automatically with fallback support.
Fetch & Manage AI Models
After saving a provider, click Fetch Models to auto-import all available models from the provider API. Then mark your preferred model as Default for Use. For Anthropic, models are added manually — use the exact model IDs such as claude-sonnet-4-6 or claude-opus-4-7.
Generate an MCP API Key for Your AI Client
In the AI Hub Dashboard, click New MCP Key. Select the target platform (Claude Desktop, Claude Code CLI, claude.ai, or OpenAI Codex CLI). The wizard generates a secure API key and renders the exact configuration snippet to paste into your AI client. The key is shown only once — copy it immediately.
Connect Claude Code CLI to Your Odoo Instance
Generate an MCP key and select Claude Code CLI as the platform. The wizard renders a ready-to-run shell command. Open a terminal, paste the command, and the MCP server is registered automatically: claude mcp add-json odoo-ai-hub '{...}' Run claude mcp list to verify registration, then restart Claude Code and type /mcp in a session to confirm the odoo-ai-hub server is connected with all Odoo tools available — no file editing required.
Connect claude.ai (Cloud) to Your Odoo Instance
Generate an MCP key and select Claude Cloud (claude.ai) as the platform. The wizard produces a single URL with the API key embedded: https://your-odoo-domain.com/mcp_gateway?api_key=YOUR_KEY In claude.ai go to Settings → Integrations → Add custom integration, paste the URL, and click Save. Start a new conversation — Odoo tools such as search_records, create_record, analyze_records and ask_ai will be available immediately. Your Odoo server must be reachable over public HTTPS.
Browse & Test MCP Tools
Go to MCP Gateway → Tools to see all registered AI tools. Each tool shows its name, description, and auto-generated JSON schema. Click Test Tool on any entry to send live parameters and inspect the real output — useful for verifying your provider and model are correctly configured before connecting an external AI client.
Set Up Bot Channels — Telegram, WhatsApp, Discord & Web Widget
Navigate to MCP Gateway → Bot Channels → New. Select a platform, paste your bot token (from @BotFather for Telegram, Meta Developer Console for WhatsApp, or Discord Developer Portal for Discord), then click Connect. Odoo registers the webhook automatically and shows a direct link to your live bot. The Web Widget requires no external account — just create the channel and send POST requests to the generated endpoint.
Monitor All AI Tool Invocations with Detailed Logs
Go to MCP Gateway → Tool Logs to audit every AI tool call made through the gateway. Each log entry records the tool name, input parameters, provider used, model used, execution duration, and the result. Use this view to debug unexpected outputs, track usage costs, and verify that tools are calling the correct AI model.
MCP Gateway Settings — Webhook Secret & Bot API Key
Go to Settings → MCP Gateway to generate the Webhook Secret (appended to every bot webhook URL to reject unauthorized requests) and the Bot MCP API Key (used internally by the bot gateway to authenticate tool calls). Both values are auto-generated with a single click and stored securely in Odoo's system parameters.
Available in Community and Enterprise
Full MCP Server Implementation
Connect OpenAI, Anthropic, Google Gemini & Custom Providers
Bot Channels for Telegram, WhatsApp & Web Widget
AI Hub Dashboard with Tool Execution Logs
User Consent Injection for Sensitive Tool Operations
Odoo MCP Gateway is a turnkey Odoo module that implements the Model Context Protocol (MCP) server standard, exposing your Odoo database as a live, structured data source for AI assistants. External tools such as Claude Desktop, Claude Code CLI, claude.ai, and OpenAI Codex can connect to it and query or modify your business data — searching records, creating entries, and running AI-powered analysis — without any custom integration code.
Any platform that supports the MCP standard can connect. The module includes built-in wizard-generated configuration snippets for: Claude Desktop (macOS, Windows, Linux), Claude Code CLI, claude.ai (web), and OpenAI Codex CLI. Additionally, users can integrate Telegram, WhatsApp, Discord bots, and a custom Web Widget chat interface through the Bot Channels feature.
Navigate to MCP Gateway → Dashboard and click the "New MCP Key" button. In the wizard, select the target platform (e.g. Claude Desktop, Claude Code CLI, claude.ai, or OpenAI Codex CLI). The system generates a secure API key, displays it once, and renders the exact configuration snippet for your chosen platform — ready to paste without any manual editing. Each user generates their own key; keys can be revoked from Settings → Technical → API Keys.
Yes. The gateway supports Ollama, which lets you run open-source models such as Llama 3, Mistral, Gemma, and Phi-4 entirely on your own hardware — no API key, no internet required, and full data privacy. Simply install Ollama, pull a model, and create a provider in Odoo with the Service set to "Ollama" and the Base URL pointing to your Ollama instance (default: http://localhost:11434). Click Fetch Models to import your locally installed models.
The Model Context Protocol (MCP) is an open standard developed by Anthropic that defines how AI assistants communicate with external data sources and tools. An MCP server exposes a structured list of callable tools (with typed parameters and descriptions) that any MCP-compatible AI client can discover and invoke. This module implements a complete MCP server inside Odoo, turning your Odoo instance into a first-class data source for any AI client that speaks MCP.
Latest Release 18.0.1.0.0
30th April, 2026- Initial Commit for Odoo MCP Gateway
Please log in to comment on this module
unusable
Not working for me , to difficult to configure , unusable
There are no comments yet!