Odoo Toolbox MCP
TypeScript SDK for Odoo; CLI; Skill modules and MCP server for AI agents. CI-tested against v17 and v18.
What is Odoo Toolbox MCP?
Odoo Toolbox MCP is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to typescript sdk for odoo; cli; skill modules and mcp server for ai agents. ci-tested against v17 and v18.
TypeScript SDK for Odoo; CLI; Skill modules and MCP server for AI agents. CI-tested against v17 and v18.
This server falls under the Business Applications category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- TypeScript SDK for Odoo; CLI; Skill modules and MCP server f
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx odoo-toolboxConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Odoo Toolbox MCP
Odoo Toolbox is a monorepo providing a TypeScript SDK, CLI, skill modules, and an MCP server for integrating AI agents with Odoo ERP instances. The `@marcfargas/odoo-mcp` target exposes Odoo operations — record CRUD, mail/chatter, module management, timesheets, accounting, and schema introspection — as MCP tools so that AI assistants such as Claude Code or Cursor can query and modify Odoo data through natural language. All knowledge modules and code examples are extracted and CI-tested against real Odoo v17 and v18 instances, making it a reliable foundation for AI-driven ERP automation.
Prerequisites
- Node.js 24 or higher
- An Odoo v17 or v18 instance accessible via HTTP/HTTPS
- Odoo URL, database name, username, and password (or API key)
- An MCP-compatible client such as Claude Desktop or Claude Code
- npx available (bundled with Node.js)
Install the Odoo CLI and MCP server via npx
You can run the packages directly via npx without a global install. To install globally for repeated use, run the npm install command.
# Run directly with npx (no install needed)
npx @marcfargas/odoo-cli --help
# Or install globally
npm install -g @marcfargas/odoo-cli @marcfargas/odoo-mcpSet Odoo connection credentials as environment variables
All Odoo Toolbox packages read connection details from these three environment variables. You can also place them in a .env file in your working directory.
export ODOO_URL=https://myodoo.example.com
export ODOO_DB=mydb
export ODOO_USERNAME=admin
export ODOO_PASSWORD=secretVerify the CLI works against your Odoo instance
Use the CLI to confirm connectivity before wiring up the MCP server. A successful search returns partner records from Odoo.
npx @marcfargas/odoo-cli records search res.partner \
--domain '[["is_company","=",true]]' --limit 5Add the MCP server to your client configuration
Edit your MCP client config file (e.g. Claude Desktop's claude_desktop_config.json or Claude Code's .claude/claude_desktop_config.json) to register the odoo-mcp server.
{
"mcpServers": {
"odoo": {
"command": "npx",
"args": ["-y", "@marcfargas/odoo-mcp"],
"env": {
"ODOO_URL": "https://myodoo.example.com",
"ODOO_DB": "mydb",
"ODOO_USERNAME": "admin",
"ODOO_PASSWORD": "secret"
}
}
}
}Restart your MCP client and verify tools are loaded
Quit and relaunch Claude Desktop or reload your Claude Code workspace. Ask the assistant to list available Odoo tools to confirm the connection is established.
Optional: install skills for richer agent knowledge
Install the AI agent skill modules (tested documentation for Odoo patterns) using the skills CLI, so your agent understands Odoo domain syntax and field types.
npx -y skills add marcfargas/odoo-toolbox --allOdoo Toolbox MCP Examples
Client configuration
Claude Desktop configuration connecting to a self-hosted Odoo v17 instance.
{
"mcpServers": {
"odoo": {
"command": "npx",
"args": ["-y", "@marcfargas/odoo-mcp"],
"env": {
"ODOO_URL": "https://myodoo.example.com",
"ODOO_DB": "mydb",
"ODOO_USERNAME": "admin",
"ODOO_PASSWORD": "secret"
}
}
}
}Prompts to try
Natural language prompts that map to Odoo RPC operations via the MCP tools.
- "Search for all company partners in Odoo and list their names and emails"
- "Create a new contact named Jane Smith with email [email protected]"
- "Post a note on CRM lead 42 saying 'Called — follow-up scheduled'"
- "Install the sale_management module in Odoo"
- "Show me the schema for the res.partner model, including all field types"
- "List all open timesheets for employee John Doe this week"Troubleshooting Odoo Toolbox MCP
Authentication fails with 'Access Denied' from Odoo
Verify that ODOO_USERNAME and ODOO_PASSWORD are correct and that the user has API access enabled. For Odoo.sh or cloud instances, you may need to generate an API key in the user profile and use it in place of the password.
npx resolves an old cached version of the package
Force the latest version by adding @latest to the package name in args: `"@marcfargas/odoo-mcp@latest"`. Alternatively clear the npx cache with `npm cache clean --force`.
Record search returns empty results despite data existing in Odoo
Check that the domain syntax follows Odoo domain notation (list of tuples). Valid example: `[["is_company","=",true]]`. Also confirm the user account has read access to the model being queried.
Frequently Asked Questions about Odoo Toolbox MCP
What is Odoo Toolbox MCP?
Odoo Toolbox MCP is a Model Context Protocol (MCP) server that typescript sdk for odoo; cli; skill modules and mcp server for ai agents. ci-tested against v17 and v18. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Odoo Toolbox MCP?
Follow the installation instructions on the Odoo Toolbox MCP GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Odoo Toolbox MCP?
Odoo Toolbox MCP works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Odoo Toolbox MCP free to use?
Yes, Odoo Toolbox MCP is open source and available under the LGPL-3.0 license. You can use it freely in both personal and commercial projects.
Odoo Toolbox MCP Alternatives — Similar Business Applications Servers
Looking for alternatives to Odoo Toolbox MCP? Here are other popular business applications servers you can use with Claude, Cursor, and VS Code.
n8n
★ 189.1kA comprehensive MCP server that provides full control over n8n automation workflows through natural language. It offers 43 tools for managing workflows, executions, credentials, and data tables, with safety features like write-mode protection and dou
LobeHub
★ 77.5k🤯 LobeHub is your Chief Agent Operator, organizing your agents into 7×24 operations by hiring, scheduling, and reporting on your entire AI team.
Jeecgboot
★ 46.4kAI 低代码平台，「低代码 + 零代码」双模式驱动：低代码一键生成前后端代码，零代码 5 分钟搭建系统，AI Skills 一句话画流程、设计表单、生成整套系统。内置 AI聊天、知识库、流程编排、MCP插件等，兼容主流大模型。引领「AI 生成 → 在线配置 → 代码生成 → 手工合并->AI修改」开发模式，消除 Java 项目 80% 的重复工作，提效而不失灵活。
CowAgent
★ 44.7kCowAgent (chatgpt-on-wechat) 是基于大模型的超级AI助理，能主动思考和任务规划、访问操作系统和外部资源、创造和执行Skills、通过长期记忆和知识库不断成长，比OpenClaw更轻量和便捷。同时支持微信、飞书、钉钉、企微、QQ、公众号、网页等接入，可选择DeepSeek/OpenAI/Claude/Gemini/ MiniMax/Qwen/GLM/LinkAI，能处理文本、语音、图片和文件，可快速搭建个人AI助理和企业数字员工。
Minds Platform
★ 39.2kPlatform dedicated to building an open foundation for applied Artificial Intelligence, designed for people seeking production-ready AI systems they can truly control, extend and deploy anywhere.
Astrbot
★ 32.8kAI Agent Assistant & development framework that integrates lots of IM platforms, LLMs, plugins and AI feature, and can be your openclaw alternative. ✨
Browse More Business Applications MCP Servers
Explore all business applications servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Odoo Toolbox MCP in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Odoo Toolbox MCP?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.