Odoo Online MCP Gateway is a free, open-source Model Context Protocol bridge for Odoo Online and Odoo Cloud (*.odoo.com) instances — the SaaS plan that has never allowed a module-based MCP server to exist. Connect Claude, Cursor, Claude Code, and any MCP client to your live Odoo Online data over its standard XML-RPC API. No module install. No approval queue. No waiting.
Every "Odoo MCP" you’ve seen is a server-side module. That makes it structurally impossible to use on Odoo Online — until now.
Odoo Online blocks custom modules
The official Odoo Online SaaS plan (every instance on *.odoo.com) does not allow installing custom server-side modules. That keeps the platform stable — but it also means a module-based MCP server, including KSROlabs’ own MCP Server for Odoo, simply cannot be installed there.
Hundreds of thousands of businesses, zero AI bridge
Odoo Online is the default plan for most small and mid-size Odoo customers. Until now, none of them had a way to connect Claude, ChatGPT, Cursor, or any AI agent directly to their live ERP data — every existing "Odoo MCP" integration on the market assumes you can install a module.
KSRO Labs built the gateway that closes the gap
Instead of waiting on Odoo to change its SaaS policy, we built an external bridge that talks to Odoo Online through its standard XML-RPC API — stable since Odoo 8 — and exposes it as an MCP endpoint. No module. No approval queue. No waiting.
Four steps from clone to conversation. Everything happens outside Odoo, so there’s nothing to install, review, or wait on.
Clone the repository and run init
Clone github.com/KSROlabs/odoo_online_mcp_gateway and run `python3 -m odoo_online_mcp_gateway init` to scaffold a ready-to-edit configuration file.
Add your Odoo Online credentials
Set ODOO_BASE_URL, ODOO_DB, ODOO_LOGIN, and ODOO_PASSWORD in your .env — the same sign-in details you already use for your *.odoo.com instance. No Odoo-side setup required.
Start the gateway
Run `python3 -m odoo_online_mcp_gateway http` (or launch the bundled Docker Compose stack) to expose an MCP endpoint at http://127.0.0.1:8787/mcp secured with Bearer-token authentication.
Connect your AI client
Point Claude Desktop, Claude Code, Cursor, or any MCP-compatible client at the gateway over stdio or HTTP — and start asking questions about your live Odoo Online data in plain English.
git clone https://github.com/KSROlabs/odoo_online_mcp_gateway.git cd odoo_online_mcp_gateway python3 -m odoo_online_mcp_gateway init # scaffolds your .env python3 -m odoo_online_mcp_gateway http # starts the MCP endpoint # → http://127.0.0.1:8787/mcp (Bearer token auth)
The gateway ships with the same security posture you’d expect from a governed enterprise integration — read-only defaults, audit trails, and granular controls.
Zero Odoo-side installation
Runs entirely outside Odoo using the standard XML-RPC API available on every Odoo Online and Odoo Cloud instance since Odoo 8 — no module review, no server access, no SaaS policy conflicts.
Conversational ERP access
Ask "show me overdue invoices over $5,000" or "which deals closed this month" and get structured answers from sales orders, invoices, inventory, contacts, and CRM leads.
Built-in analytics tools
`list_models`, `describe_model`, `search_records`, `get_record`, and `aggregate_records` let agents explore your schema and run grouped aggregations — no SQL required.
Read-only by default
Write tools — `create_record`, `update_record`, `delete_record` — ship disabled. Enabling them requires an explicit `allow_ops` flag plus a confirmation step before anything changes.
Token auth, rate limits, allowlists
Bearer-token authentication, configurable rate limits, payload size caps, model allowlisting, and field-level access control keep the gateway production-safe.
Audit logging built in
Every tool call is logged for compliance and troubleshooting, with optional error redaction so sensitive details never leak into your logs.
Read tools are on by default. Write tools stay off until you explicitly enable and confirm them.
list_modelsRead · default-on
Lists the Odoo models the current token can access.
describe_modelRead · default-on
Returns field definitions and metadata so an agent can plan a query before running it.
search_recordsRead · default-on
Searches records using Odoo domain filters — the same filtering language Odoo itself uses.
get_recordRead · default-on
Fetches a single record by ID with field-level access control applied.
aggregate_recordsRead · default-on
Runs sums, counts, and group-bys for lightweight reporting and analytics.
create_record / update_record / delete_recordWrite · opt-in + confirmation
Modify Odoo Online data — disabled until you explicitly set `allow_ops` and confirm the change.
Both are built and maintained by KSRO Labs. The right one for you depends entirely on how your Odoo is hosted.
Self-hosted · Odoo.sh · On-Premise
Our flagship native module — install it directly inside Odoo for OAuth clients, scoped API keys, prompt-to-portal pages, the KSRO AI Engine, Web Notify, audit logs, and fully managed deployment support.
Explore MCP Server for Odoo →Odoo Online · Odoo Cloud · *.odoo.com
Our free, open-source external bridge — no module install, ever. Self-host it in minutes with Python or Docker and connect AI agents to your Odoo Online instance via XML-RPC.
Get the Gateway on GitHub →Clone it, star it, run it — it’s free and open source. Or talk to KSRO Labs about managed deployment if you’d rather we run it for you.
Common questions about connecting AI agents to Odoo Online and Odoo Cloud instances.
Yes. KSROlabs built and open-sourced the Odoo Online MCP Gateway specifically for this. It runs outside Odoo and connects over XML-RPC, so you can link Claude Desktop, Claude Code, Cursor, ChatGPT-compatible MCP clients, and any other Model Context Protocol client to your live Odoo Online data — without installing anything inside Odoo.
Odoo Online — the official cloud SaaS plan hosted on *.odoo.com — does not allow installing custom server-side modules. That restriction applies to every module-based MCP integration, including our own MCP Server for Odoo. The Odoo Online MCP Gateway exists to work around exactly this limitation by running externally and talking to Odoo through its standard XML-RPC API instead of installing code on the server.
Yes — it is fully open source under the MIT License. Clone it from GitHub, run it on your own machine, server, or container platform, and use it for free. KSRO Labs also offers managed deployment and support for teams that would rather not self-host it.
No. The gateway runs completely outside Odoo and authenticates with the same login credentials you already use for your *.odoo.com instance, communicating over Odoo’s standard XML-RPC API — the same stable interface available since Odoo 8.
Any Odoo Online or Odoo Cloud instance running Odoo 16, 17, or 18, plus any other Odoo deployment that exposes the standard XML-RPC endpoint. Because it relies on a long-stable API rather than internal module hooks, it keeps working across upgrades.
The gateway is designed read-only by default — write tools are disabled until you explicitly opt in and confirm. It layers on Bearer-token authentication, configurable rate limits, payload size caps, model allowlisting, field-level access control, and full audit logging, so you stay in control of exactly what AI agents can see and do.
The MCP Server for Odoo is a native Odoo module for self-hosted, Odoo.sh, and on-premise deployments — it offers OAuth clients, scoped API keys, prompt-to-portal pages, the KSRO AI Engine, Web Notify, and managed hosting. The Odoo Online MCP Gateway is a free, open-source external bridge built specifically for Odoo Online (SaaS) instances that cannot install custom modules at all. Pick the one that matches how your Odoo is hosted — or use both if you run a mixed environment.
Yes. While the gateway is free and self-hostable, KSRO Labs offers managed deployment, configuration, and support for teams that want it running in production without managing the infrastructure themselves. Reach out through our contact page to discuss managed hosting.
Self-hosted, Odoo.sh, or on-premise? Explore the full MCP Server for Odoo — OAuth clients, the KSRO AI Engine, Web Notify, and managed deployment.