Claude Connector Odoo
Bring Claude AI into your Odoo ERP — securely, natively, in minutes
What is Claude Connector Odoo?
Claude Connector Odoo is a production-ready MCP (Model Context Protocol) server embedded inside Odoo Community. It lets Claude Desktop and Claude.ai talk directly to your ERP: list models, search records, read data, and (when you allow it) create or update business documents — all through natural language.
Unlike fragile scripts or external middlewares, the connector runs natively in Odoo. Authentication uses modern OAuth 2.1 + PKCE (Sign in with Odoo). Access is controlled by a model whitelist (scopes), Safe Mode, daily quotas and a full audit log. You decide exactly what Claude can see and do.
Ideal for consultants, SMEs and technical teams who want Claude as a secure assistant on top of Contacts, Products, Sales, Accounting and more — without exposing the whole database.
Why choose this module?
Native & reliable
MCP endpoints live inside Odoo (/mcp/sse). No fragile bridge server to maintain.
Enterprise-grade security
OAuth 2.1 / PKCE, per-model scopes, Safe Mode (blocks writes), quotas and audit trail.
Built for Claude
Works with Claude Connectors (custom remote MCP). Streamable HTTP + classic SSE supported.
Key features
- Native MCP server:
/mcp/health,/mcp/sse,/mcp/messages - OAuth 2.1 + PKCE + Dynamic Client Registration (static Client ID supported)
- Legacy Bearer tokens still available
- Tools:
odoo_list_models,odoo_describe_model,odoo_search_read,odoo_read,odoo_create,odoo_write,odoo_company_context - Scope packs (Contacts, Inventory, Sales, Accounting, Custom)
- Safe Mode, multi-company aware domain, daily quota, audit log
- Compatible with Odoo 17.0 / 18.0 / 19.0
- License OPL-1 · Price 90 USD
Prerequisites
- Odoo Community (or Enterprise) with this module installed and updated
- Public HTTPS URL (example:
https://your-domain.com) - Correct
dbfilterif you host multiple databases - Claude account with access to Connectors
- An internal Odoo user (portal users cannot authorize MCP)
How to connect Claude — step by step
Follow these steps after installing Claude Connector Odoo and setting your Public Base URL in Odoo (Merkago MCP settings).
Step 1 — Open Claude Connectors
In Claude go to Settings → Customize → Connectors. Click the Add button at the top right.
Step 2 — Add a custom connector
From the Add menu, choose Add custom connector (do not use “Browse connectors”).
Step 3 — Name and remote MCP URL
Fill the form as follows:
- Name:
Merkago(or any label you prefer) - Remote MCP server URL:
https://YOUR-DOMAIN/mcp/sse
Important: use a single https:// and forward slashes
/ only. Example: https://merkago.net/mcp/sse
Step 4 — OAuth settings and authorize
- OAuth Client ID (recommended):
merkago-claude-desktop— or leave empty to use Dynamic Client Registration - OAuth Client Secret: leave empty
- Click Add
- Claude opens the Merkago login page → sign in with an internal Odoo user → Authorize
When connected, Claude tools from this module appear under the connector permissions.
Step 5 — Whitelist models (scopes) in Odoo
In Odoo open Merkago MCP → Tokens / Scopes. Attach only the models Claude is allowed to use (Contacts, Products, Users…). What is not in the whitelist is invisible to Claude.
Step 6 — Create a scope (example: Products)
- Name: Products / Templates
- Model:
product.template - Pack: Inventory
- Perm Read: Yes · Write / Create / Unlink: No (recommended at first)
- Extra Domain: leave empty for products
(the example
[('customer_rank','>',0)]is for contacts only) - Save, then link the scope to the Claude token
Quick test in Claude
In a new Claude chat, ask:
“Use the Merkago tool odoo_list_models now (not your memory), then count product.template with odoo_search_read.”
Keep Safe Mode enabled in production until you explicitly want Claude to create/write records.
Support — AKREM.KHELIFI
Email:
akremkhelifi07@gmail.com
WhatsApp:
+216 54 444 373
Website:
https://merkago.net
Need a custom rule (hide cost only on website, stock valuation, PDF reports)? Contact us for a tailored extension.
License: OPL-1 · Price: 90.00 USD
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Contacts (contacts)
• Discuss (mail) |
| Lines of code | 1657 |
| Technical Name |
merkago_mcp_server |
| License | OPL-1 |
| Website | https://merkago.net |
Odoo Proprietary License v1.0 This software and associated files (the "Software") may only be used (executed, modified, executed after modifications) if you have purchased a valid license from the authors, typically via Odoo Apps, or if you have received a written agreement from the authors of the Software (see the COPYRIGHT file). You may develop Odoo modules that use the Software as a library (typically by depending on it, importing it and using its resources), but without copying any source code or material from the Software. You may distribute those modules under the license of your choice, provided that this license is compatible with the terms of the Odoo Proprietary License (For example: LGPL, MIT, or proprietary licenses similar to this one). It is forbidden to publish, distribute, sublicense, or sell copies of the Software or modified copies of the Software. The above copyright notice and this permission notice must be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
Please log in to comment on this module