MCP Server Odoo
MCP Server Odoo is an MCP server that enables AI assistants like Claude to interact with Odoo ERP systems. Access business data, search records, create new entries, update existing data, and manage your Odoo instance through natural language. It has 407 GitHub stars, is released under the MPL-2.0 license and runs locally with uvx mcp-server-odoo.
github.com/ivnvxd/mcp-server-odoo (opens in a new tab)
Data as of from the GitHub API; description from the project's repository. Report an error
- Needs API key
- AI & search
- MPL-2.0
- Active
Install MCP Server Odoo
Generated from the server's published package. Replace your-value with your own values.
Claude Desktop
{
"mcpServers": {
"mcp-server-odoo": {
"command": "uvx",
"args": [
"mcp-server-odoo"
],
"env": {
"ODOO_API_KEY": "your-value",
"ODOO_PASSWORD": "your-value"
}
}
}
}Settings > Developer > Edit Config. macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\. Restart Claude Desktop afterwards.
Claude Code
claude mcp add --env ODOO_API_KEY=your-value --env ODOO_PASSWORD=your-value --transport stdio mcp-server-odoo -- uvx mcp-server-odooCursor
{
"mcpServers": {
"mcp-server-odoo": {
"type": "stdio",
"command": "uvx",
"args": [
"mcp-server-odoo"
],
"env": {
"ODOO_API_KEY": "your-value",
"ODOO_PASSWORD": "your-value"
}
}
}
}Project file; use ~/.cursor/mcp.json to enable it in every project.
VS Code
{
"inputs": [
{
"type": "promptString",
"id": "odoo_api_key",
"description": "ODOO_API_KEY",
"password": true
},
{
"type": "promptString",
"id": "odoo_password",
"description": "ODOO_PASSWORD",
"password": true
}
],
"servers": {
"mcp-server-odoo": {
"type": "stdio",
"command": "uvx",
"args": [
"mcp-server-odoo"
],
"env": {
"ODOO_API_KEY": "${input:odoo_api_key}",
"ODOO_PASSWORD": "${input:odoo_password}"
}
}
}
}Config formats checked against the official docs on Oct 7, 2026: modelcontextprotocol.io (opens in a new tab), code.claude.com (opens in a new tab), cursor.com (opens in a new tab), code.visualstudio.com (opens in a new tab).
Environment variables
Variables the server reads at startup.
| Name | Required | Description |
|---|---|---|
ODOO_URL | No | Shown in the README's example configuration. |
ODOO_API_KEYsecret | No | Shown in the README's example configuration. |
ODOO_DB | No | Shown in the README's example configuration. |
ODOO_ALLOWED_COMPANIES | No | Shown in the README's example configuration. |
ODOO_USER | No | Shown in the README's example configuration. |
ODOO_PASSWORDsecret | No | Shown in the README's example configuration. |
ODOO_YOLO | No | Shown in the README's example configuration. |
SSL_CERT_FILE | No | Shown in the README's example configuration. |
ODOO_MCP_LOG_LEVEL | No | Shown in the README's example configuration. |
Tools (20)
Parsed from the Tools section of the README; check the repository for the current list.
search_recordsSearch for records in any Odoo model with filters.
get_recordRetrieve a specific record by ID.
get_fieldsDescribe a model's fields — type, label, required/readonly, relation target, and selection options.
get_current_contextReturn the current session context: the connected user, their timezone, the active company plus any other allowed…
list_modelsList all models enabled for MCP access.
list_resource_templatesList available resource URI templates and their patterns.
create_recordCreate a new record in Odoo.
create_recordsCreate several records of one model in one call. The call accepts at most 100 records.
update_recordUpdate an existing record.
update_recordsUpdate several records of one model in one call, with at most 100 distinct records.
delete_recordDelete a record from Odoo.
read_attachmentRead a file: an attachment or a binary field such as an image.
list_record_attachmentsList the files attached to a record, newest first, with name, mimetype, size, date and an odoo://attachment/{id} URI…
upload_attachmentAttach a file to a record. data is the file as plain base64, at most about 2.9 MB after decoding.
post_messagePost a message to a record's chatter (mail.thread). subtype="note" (default) is an internal log; subtype="comment"…
aggregate_recordsServer-side aggregation. Use this whenever the question is "totals/counts/groupings" rather than "list of records" —…
call_model_methodGeneric XML-RPC executekw escape hatch — invokes public business methods, for workflow actions not covered by CRUD…
allowed_company_idsThe companies of the call. The first one is the active company, so company-dependent fields such as standardprice read…
langThe language of labels and translated values. A language that Odoo has not installed is refused.
active_testfalse includes archived records in searches.
About MCP Server Odoo
An MCP server that enables AI assistants like Claude to interact with Odoo ERP systems. Access business data, search records, create new entries, update existing data, and manage your Odoo instance through natural language.
- mcp
- mcp-server
- odoo
- ai
- erp
- llm
- model-context-protocol
- mcp-servers
- odoo-mcp
Similar MCP servers
More ai & search MCP servers
MCP Local RAG
shinpr/mcp-local-rag
Easy-to-setup local RAG server with minimal configuration.
Active · last commit Oct 22, 2026
AI & searchTypeScriptPageIndex MCP
VectifyAI/pageindex-mcp
Reasoning-based RAG system for chatting with long PDFs.
Maintained · last commit Jul 25, 2026
AI & searchTypeScriptMarm MCP Server
Lyellr88/marm-memory
Universal MCP Server with advanced AI memory capabilities and semantic search.
Active · last commit Oct 23, 2026
AI & searchPythonNanobanana MCP Server
zhongweili/nanobanana-mcp-server
An MCP server that provides image generation and editing capabilities.
Active · last commit Oct 2, 2026
AI & searchPythonContext
neuledge/context
Local-first documentation for AI agents. Offline, instant, private doc retrieval.
Maintained · last commit Oct 26, 2026
OfficialAI & searchTypeScriptKindly Web Search MCP Server
Shelpuk-AI-Technology-Consulting/kindly-web-search-mcp-server
Kindly Web Search MCP Server: Web search + robust content retrieval for AI coding tools (Claude Code, Codex, Cursor, GitHub Copilot, Gemini, etc.) and AI agents (Claude Desktop, OpenClaw, Hermes…
Maintained · last commit Oct 10, 2026
AI & searchPython
How do I install the MCP Server Odoo MCP server?
Add the command uvx mcp-server-odoo to your MCP client: put it in claude_desktop_config.json for Claude Desktop, run claude mcp add for Claude Code, or add it to .cursor/mcp.json (Cursor) or .vscode/mcp.json (VS Code). The snippets on this page are ready to paste.
Is MCP Server Odoo free?
The server is open source under the MPL-2.0 license, so running it is free. It needs credentials (ODOO_API_KEY and ODOO_PASSWORD) for the service it connects to, which may require a paid account.
Is MCP Server Odoo actively maintained?
The most recent commit was on Oct 10, 2026. The latest release is v0.9.0, published Oct 10, 2026. appsgit only lists MCP servers with a commit in the last six months.