MCP Server for Odoo
MCP server for Odoo: the agent reads, creates and updates ERP records, searches data and calls business operations within Odoo permissions
- 415 ★ on the repository
- Last commit
- MPL-2.0
Broad access
Why this level
- Creates, updates and deletes records in an ERP database
- Requires an API key or username and password for the Odoo instance
- YOLO mode and model method calls bypass security checks
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add mcp/mcp-server-for-odooDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewBroad accessThe tool can change data, run commands or handle secrets.
- Creates, updates and deletes records in an ERP database
- Requires an API key or username and password for the Odoo instance
- YOLO mode and model method calls bypass security checks
This is third-party code. Review the repository files before installing.
What it does
The server gives an agent access to an Odoo ERP system through standard resources and tools. The agent searches and retrieves any records, from customers and products to invoices, creates new records with field and permission validation, updates and deletes data respecting model permissions, and counts records by criteria. It offers server-side aggregation, an opt-in call of public business methods, work with attachments and binary files via resource URIs, and smart field selection per model. It installs via uvx from PyPI or runs in docker.
Who it is for. For developers, sales and finance staff who work with data in Odoo.
Good fit when
- You need to search and retrieve Odoo records from an agent
- You need to create or update ERP data with permission checks
- You need a summary or aggregation over records on the server side
Not a fit when
- You have no access to an Odoo instance or user permissions
- You do not want to give an agent write access to a live ERP database
- You need read-only preview rather than mutating operations
Example request
Find unpaid invoices in Odoo for the last month and show totals by customerMCP
- Transport
- stdio
- Authentication
- key is optional
Environment variables
ODOO_URLrequired- URL of the Odoo instance
ODOO_API_KEYsecret- API key for login, an alternative to the username and password pair
ODOO_USER- Username when logging in without an API key
ODOO_PASSWORDsecret- Password when logging in without an API key
ODOO_DB- Database name when it is not auto-detected
Limitations
You need access to an Odoo instance: ODOO_URL is required, and login uses either ODOO_API_KEY or the pair ODOO_USER and ODOO_PASSWORD. Production mode needs the Odoo MCP module and version 16 or newer; the YOLO mode for testing bypasses security checks and suits demos only. Calling model methods is enabled separately and requires YOLO, which is a dangerous option. The server runs on your machine, not on the Odoo server.
How to disable. Remove the odoo entry from your MCP client config, stop the docker container if running, and revoke the API key in Odoo settings.
FAQ
What is needed on the Odoo side?
Production mode needs the Odoo MCP module and version 16 or newer. YOLO mode works without the module but bypasses security checks and suits testing only.
How do I configure login?
ODOO_URL is required. Login uses either ODOO_API_KEY or the pair ODOO_USER and ODOO_PASSWORD. Set ODOO_DB when the database is not auto-detected.
How is MCP Server for Odoo different from direct Odoo API access?
The server gives the agent access to Odoo ERP through standard resources and tools: search any records from customers and products to invoices, create records with field and permission checks and call business operations through Odoo rights.
What is needed on the Odoo side to connect?
You need an Odoo user with limited rights and API access. The server connects with the uvx command, the config is in the install block. It works with Claude Desktop, Claude Code, Cursor, VS Code and Copilot. Risk is high because the agent writes to the ERP.
Discussion
No questions or reviews yet.
Related
MCP serversA self-hosted MCP server for Odoo: read and gated writes of ERP data through an agent, any edition and version
An Odoo connector for the agent: search, create and edit records of any ERP model in plain language, Odoo versions 14 to 20
A minimal MCP server for amoCRM API v4: read and create leads, contacts and notes, with OAuth2 and long-term tokens
MCP server for the amoCRM (Kommo) API v4: leads, contacts, companies, tasks, pipelines, unsorted inbox and analytics
MCP server for ERPNext and Frappe: documents, stock and sales from chat, plus nine viewer windows in the client
Kommo CRM MCP server
Kommo MCP Server
A Python MCP server with OAuth for Kommo CRM: leads, contacts, pipelines, tags, tasks, and generic GET, POST, PATCH calls to the API
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Authentication | Repository stars | Main difference |
|---|---|---|---|---|
| MCP Server for Odoo (this card) | no | key is optional | 415 | |
| kubectl-mcp-server | no | not required | 972 | reads cluster state and diagnoses pod failures |
| Unreal Engine MCP Server | no | not required | 1,033 | Unreal Engine assets, actors and blueprints |
| Android MCP | no | not required | 924 | controls an Android device through ADB |
README in short
The README describes a server that gives assistants access to Odoo ERP: search, read, create, update and delete records, counting, field inspection, server-side aggregation, an optional business method call and attachment handling. It shows UV install and configs for Claude Desktop, Claude Code, Cursor and VS Code via uvx mcp-server-odoo, plus a docker run. It includes a variable table: ODOO_URL, ODOO_API_KEY, ODOO_USER, ODOO_PASSWORD, ODOO_DB and others. The YOLO test mode is documented separately. MPL-2.0 licensed.