ERPipe — MCP for Odoo

Open-source TypeScript building blocks for remote MCP access to Odoo.

Try it (real Odoo only): create a free v1 workspace, add one or more HTTPS Odoo instances, then connect ChatGPT, Codex CLI, Claude Code, Gemini CLI, Antigravity CLI, or Grok to the shared endpoint https://mcp.erpipe.com/mcp. Follow the human setup recipe or copy a prompt for your AI agent. There is no shared public sandbox.

Why

• Talk to Odoo from ChatGPT, Codex CLI, Claude Code, Gemini CLI, Antigravity CLI, Grok, Cursor, and custom MCP agents over a stable URL shape

• Workers-safe XML-RPC + JSON-2 transports

• Gated writes (preview → approve → execute) with field policy

• Shared 26-tool + 7-prompt core surface in @erpipe/core (D14 parity set of 23 plus model_facts, read_attachment, render_report) — hosted workspace is 37 tools (multi-instance, lifecycle, webhook events, ping) — see docs/tools.md

Related MCP server: MCP Server for Odoo

Status

Pins:

Packages

Requirements

• Node.js ≥ 20 (CI uses 22 — .nvmrc)

• npm

• Optional: Cloudflare account for deploy:selfhost

• Optional: Odoo 16–19 for live smoke

Install

npm install @erpipe/core @erpipe/odoo-xmlrpc

Self-host Worker example stays in this monorepo only (@erpipe/worker-selfhost is private / not published).

Develop from source

git clone https://github.com/erpipe-org/erpipe.git
cd erpipe
npm install
npm run build
npm run typecheck
npm test

Quick start (self-host Worker)

npm run dev:selfhost
# Home: http://127.0.0.1:8787/
# MCP:  http://127.0.0.1:8787/default/mcp

Deploy:

# set secrets first — see packages/worker-selfhost/README.md
npm run deploy:selfhost

Canonical MCP URLs

Hosted setup: mcp.erpipe.com/docs/connector · compatibility: erpipe.com/compatibility

Reserved path segments (never use as a self-host connection id): authorize, token, register, mcp, sse, .well-known, assets, health, app, admin.

Docs

Architecture (high level)

MCP client  ──OAuth + MCP──►  Worker (self-host or hosted)
                                  │
                                  ▼
                           @erpipe/core tools
                                  │
                    ┌─────────────┴─────────────┐
                    ▼                           ▼
             XmlRpcTransport              Json2Transport
                    │                           │
                    └──────────► Odoo ◄─────────┘

Contributing

See CONTRIBUTING.md. Please read the Code of Conduct.

License

MIT — see LICENSE.

"Odoo" is a trademark of Odoo S.A. ERPipe is not affiliated with Odoo S.A.