Niyu MCP Server for Odoo: Overview
Understand what the MCP server does, how AI clients connect to Odoo, where security is enforced, and which Odoo menus customers use.
Niyu MCP Server turns an Odoo 19 database into a governed MCP endpoint that ChatGPT, Claude, Cursor, Codex, automation tools, and other compatible clients can use to read or act on live ERP data.
Note: No separate middleware is required The main Streamable HTTP MCP server runs inside Odoo at /mcp. A local Python bridge is optional for development and localhost workflows.
Note: Documentation version This guide matches module version 19.0.7.0.0 for Odoo 19. Client interfaces may change while the Odoo setup and security model remain the same.
What MCP means
Model Context Protocol (MCP) is a standard way for an AI client to discover tools, prompts, and resources from another system. Here, Odoo is the system providing those capabilities.
How a request works
- An AI client connects to the public Odoo MCP URL, normally https://your-odoo-domain.com/mcp.
- The client authenticates with OAuth or a scoped API key.
- The request runs as a specific internal Odoo user.
- Odoo ACLs and record rules are applied.
- MCP access bundles, model permissions, field rules, forced domains, limits, and tool blocks are applied as additional restrictions.
- The approved ORM operation runs and the result is audited.
Main capabilities
- Discover exposed models, fields, business terms, instance guidance, prompts, and resources.
- Search, read, count, aggregate, create, update, delete, and use chatter when every permission layer allows it.
- Run grouped, pivot, time-series, top-N, funnel, and cohort analysis.
- Export governed datasets as CSV, JSON, or XLSX and queue larger read/export jobs.
- Create governed dashboards and reusable prompt templates.
- Build safe data-only Odoo modules containing custom x_ models, fields, views, menus, and access records.
Where to find the module in Odoo
| Area | Odoo location | Purpose |
|---|---|---|
| Settings | Settings > MCP Server | Enable the endpoint, set the public URL, choose authentication and data-access mode, and configure monitoring or advanced controls. |
| Connections | MCP Server > Connections | See connected users and clients; disable or re-enable a connection. |
| Access Bundles | MCP Server > Access Bundles | Choose exact Odoo models and define MCP-only permissions and governance. |
| API Keys | MCP Server > API Keys / Generate API Key | Create, rotate, expire, and revoke user-bound scoped keys. |
| Async Jobs | MCP Server > Async Jobs | Review queued counts and exports. |
| Dashboards | MCP Server > Dashboards | Create and share governed dashboards. |
| Prompt Templates | MCP Server > Prompt Templates | Create reusable prompts visible to selected MCP users. |
| Safe Module Builder | MCP Server > Safe Module Builder | Build and install data-only modules; administrator only. |
| Audit Logs | MCP Server > Audit Logs | Review MCP requests, decisions, failures, and timing. |
| Built-in Help | MCP Server > Documentation | Open the server-generated capability page at /mcp/docs. |
Recommended first deployment
Start with OAuth, bundle enforcement, one read-only access bundle, a small list of business models, and a non-administrator test user. Validate read requests before enabling create, update, export, chatter, or delete capabilities.