Odoo

v1.0.0Business Applicationsstable

Odoo MCP Server - Model Context Protocol server for Odoo ERP integration. Supports Odoo 14-19+ with JSON-RPC and REST API.

ai-agentcursor-ideerpmcpmodel-context-protocol
Share:
9
Stars
0
Downloads
0
Weekly
0/5

What is Odoo?

Odoo is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to odoo mcp server - model context protocol server for odoo erp integration. supports odoo 14-19+ with json-rpc and rest api.

Odoo MCP Server - Model Context Protocol server for Odoo ERP integration. Supports Odoo 14-19+ with JSON-RPC and REST API.

This server falls under the Business Applications category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • Odoo MCP Server - Model Context Protocol server for Odoo ERP

Use Cases

Query and update Odoo ERP data (sales, inventory, HR) via AI agents.
Automate Odoo workflows with natural language commands.
rachmataditiya

Maintainer

LicenseAGPL-3.0
Languagerust
Versionv1.0.0
UpdatedApr 9, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx odoo-rust

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Odoo

The Odoo Rust MCP Server is a high-performance Model Context Protocol server written in Rust that connects AI assistants to Odoo ERP instances running versions 14 through 19+. It supports both JSON-RPC (for Odoo < 19) and the REST API (for Odoo 19+), exposes over 15 tools for searching, reading, creating, updating, and deleting records, and can manage multiple Odoo instances simultaneously.

Prerequisites

  • Odoo ERP instance version 14 or newer (cloud or self-hosted)
  • Odoo API key (for Odoo 19+) or admin username/password (for Odoo < 19)
  • macOS or Linux for Homebrew/APT install, or Docker for containerized deployment
  • Rust toolchain only if building from source
  • MCP-compatible client such as Claude Desktop or Cursor IDE
1

Install via Homebrew (macOS/Linux)

The Homebrew tap is the easiest way to install on macOS and Linux. It automatically creates the config directory and sets up systemd/launchd service management.

brew tap rachmataditiya/odoo-rust-mcp
brew install rust-mcp
2

Install via APT (Debian/Ubuntu)

Add the signed APT repository and install the package. This method is recommended for Ubuntu/Debian servers.

curl -fsSL https://rachmataditiya.github.io/odoo-rust-mcp/pubkey.gpg | sudo gpg --dearmor -o /usr/share/keyrings/rust-mcp.gpg
echo "deb [signed-by=/usr/share/keyrings/rust-mcp.gpg] https://rachmataditiya.github.io/odoo-rust-mcp stable main" | sudo tee /etc/apt/sources.list.d/rust-mcp.list
sudo apt update && sudo apt install rust-mcp
3

Configure environment variables

Set credentials for your Odoo instance. Use an API key for Odoo 19+, or username/password for earlier versions. Edit the env file created by the Homebrew install.

# For Odoo 19+ (API Key method) — edit ~/.config/odoo-rust-mcp/env
ODOO_URL=https://mycompany.odoo.com
ODOO_API_KEY=your_api_key_here
ODOO_DB=mycompany

# For Odoo 14-18 (username/password method)
ODOO_URL=https://mycompany.odoo.com
ODOO_DB=mycompany
ODOO_VERSION=18
ODOO_USERNAME=admin
ODOO_PASSWORD=your_password
4

Configure Claude Desktop or Cursor (STDIO transport)

Add the server to your MCP client configuration. Use the absolute path to the rust-mcp binary installed by Homebrew.

{
  "mcpServers": {
    "odoo": {
      "command": "/opt/homebrew/bin/rust-mcp",
      "args": ["--transport", "stdio"],
      "env": {
        "ODOO_URL": "https://mycompany.odoo.com",
        "ODOO_API_KEY": "your_api_key_here",
        "ODOO_DB": "mycompany"
      }
    }
  }
}
5

Start the service and validate config

Start the server as a background service (Homebrew) or validate your configuration before first use.

# Homebrew service
brew services start rust-mcp

# Validate configuration
./rust-mcp validate-config

# Check health (HTTP transport)
curl http://127.0.0.1:8787/health

Odoo Examples

Client configuration

Complete Claude Desktop configuration for Odoo 19+ using STDIO transport with an API key.

{
  "mcpServers": {
    "odoo": {
      "command": "/opt/homebrew/bin/rust-mcp",
      "args": ["--transport", "stdio"],
      "env": {
        "ODOO_URL": "https://mycompany.odoo.com",
        "ODOO_API_KEY": "your_odoo_api_key",
        "ODOO_DB": "mycompany"
      }
    }
  }
}

Prompts to try

Ask Claude these questions once the Odoo MCP server is connected.

- "List all companies in my Odoo CRM"
- "Show me open sales orders from this month"
- "Create a new contact named Acme Corp as a company"
- "How many products do we have in stock below reorder point?"
- "Generate a PDF report for invoice INV/2024/0001"

Troubleshooting Odoo

Authentication error connecting to Odoo

For Odoo 19+, API keys must be generated in Settings → Technical → API Keys (requires developer mode). For Odoo < 19, use username/password and set ODOO_VERSION to match your actual version (e.g. 16, 17, 18). Verify the ODOO_URL does not have a trailing slash.

Write tools (create/update/delete) are not appearing

Write operations are enabled by default but may be restricted by the Odoo user's access rights. Check that the configured Odoo user has write permissions on the models you are trying to modify via Settings → Users in Odoo.

Cleanup tools not available

The odoo_database_cleanup and odoo_deep_cleanup tools are disabled by default for safety. Set ODOO_ENABLE_CLEANUP_TOOLS=true in your environment to enable them. Use with caution on production instances.

Frequently Asked Questions about Odoo

What is Odoo?

Odoo is a Model Context Protocol (MCP) server that odoo mcp server - model context protocol server for odoo erp integration. supports odoo 14-19+ with json-rpc and rest api. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Odoo?

Follow the installation instructions on the Odoo GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Odoo?

Odoo works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Odoo free to use?

Yes, Odoo is open source and available under the AGPL-3.0 license. You can use it freely in both personal and commercial projects.

Odoo Alternatives — Similar Business Applications Servers

Looking for alternatives to Odoo? Here are other popular business applications servers you can use with Claude, Cursor, and VS Code.

n8n

189.1k

A 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.4k

AI 低代码平台,「低代码 + 零代码」双模式驱动:低代码一键生成前后端代码,零代码 5 分钟搭建系统,AI Skills 一句话画流程、设计表单、生成整套系统。内置 AI聊天、知识库、流程编排、MCP插件等,兼容主流大模型。引领「AI 生成 → 在线配置 → 代码生成 → 手工合并->AI修改」开发模式,消除 Java 项目 80% 的重复工作,提效而不失灵活。

CowAgent

44.7k

CowAgent (chatgpt-on-wechat) 是基于大模型的超级AI助理,能主动思考和任务规划、访问操作系统和外部资源、创造和执行Skills、通过长期记忆和知识库不断成长,比OpenClaw更轻量和便捷。同时支持微信、飞书、钉钉、企微、QQ、公众号、网页等接入,可选择DeepSeek/OpenAI/Claude/Gemini/ MiniMax/Qwen/GLM/LinkAI,能处理文本、语音、图片和文件,可快速搭建个人AI助理和企业数字员工。

Minds Platform

39.2k

Platform 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.8k

AI 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.

Quick Config Preview

{ "mcpServers": { "odoo-rust": { "command": "npx", "args": ["-y", "odoo-rust"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Odoo?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides