Odoo MCP Server
by ebmurhaio.github.ebmurha/odoo-mcpv0.3.0
Workflow-native MCP server for safe Odoo Enterprise back-office operations
context tax
queued
security
queued
cold start
queued
freshness
Active13d ago
Install Odoo MCP server
Install in Claude Code
claude mcp add odoo-erp -e ODOO_MCP_ODOO_URL='<odoo-mcp-odoo-url>' -e ODOO_MCP_ODOO_DATABASE='<odoo-mcp-odoo-database>' -e ODOO_MCP_ODOO_USERNAME='<odoo-mcp-odoo-username>' -e ODOO_MCP_ODOO_API_KEY='<odoo-mcp-odoo-api-key>' -e ODOO_MCP_ALLOWED_COMPANY_IDS='<odoo-mcp-allowed-company-ids>' -e ODOO_MCP_DEFAULT_COMPANY_ID='<odoo-mcp-default-company-id>' -- uvx odoo-erp-mcp --config '<--config>'Install in Cursor
{
"mcpServers": {
"odoo-erp": {
"command": "uvx",
"args": [
"odoo-erp-mcp",
"--config",
"<--config>"
],
"env": {
"ODOO_MCP_ODOO_URL": "<odoo-mcp-odoo-url>",
"ODOO_MCP_ODOO_DATABASE": "<odoo-mcp-odoo-database>",
"ODOO_MCP_ODOO_USERNAME": "<odoo-mcp-odoo-username>",
"ODOO_MCP_ODOO_API_KEY": "<odoo-mcp-odoo-api-key>",
"ODOO_MCP_ALLOWED_COMPANY_IDS": "<odoo-mcp-allowed-company-ids>",
"ODOO_MCP_DEFAULT_COMPANY_ID": "<odoo-mcp-default-company-id>"
}
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).
Install in Claude Desktop
{
"mcpServers": {
"odoo-erp": {
"command": "uvx",
"args": [
"odoo-erp-mcp",
"--config",
"<--config>"
],
"env": {
"ODOO_MCP_ODOO_URL": "<odoo-mcp-odoo-url>",
"ODOO_MCP_ODOO_DATABASE": "<odoo-mcp-odoo-database>",
"ODOO_MCP_ODOO_USERNAME": "<odoo-mcp-odoo-username>",
"ODOO_MCP_ODOO_API_KEY": "<odoo-mcp-odoo-api-key>",
"ODOO_MCP_ALLOWED_COMPANY_IDS": "<odoo-mcp-allowed-company-ids>",
"ODOO_MCP_DEFAULT_COMPANY_ID": "<odoo-mcp-default-company-id>"
}
}
}
}Settings → Developer → Edit Config (claude_desktop_config.json), then restart.
Install in VS Code
{
"servers": {
"odoo-erp": {
"type": "stdio",
"command": "uvx",
"args": [
"odoo-erp-mcp",
"--config",
"<--config>"
],
"env": {
"ODOO_MCP_ODOO_URL": "<odoo-mcp-odoo-url>",
"ODOO_MCP_ODOO_DATABASE": "<odoo-mcp-odoo-database>",
"ODOO_MCP_ODOO_USERNAME": "<odoo-mcp-odoo-username>",
"ODOO_MCP_ODOO_API_KEY": "<odoo-mcp-odoo-api-key>",
"ODOO_MCP_ALLOWED_COMPANY_IDS": "<odoo-mcp-allowed-company-ids>",
"ODOO_MCP_DEFAULT_COMPANY_ID": "<odoo-mcp-default-company-id>"
}
}
}
}Add to .vscode/mcp.json in your workspace.
Install in Windsurf
{
"mcpServers": {
"odoo-erp": {
"command": "uvx",
"args": [
"odoo-erp-mcp",
"--config",
"<--config>"
],
"env": {
"ODOO_MCP_ODOO_URL": "<odoo-mcp-odoo-url>",
"ODOO_MCP_ODOO_DATABASE": "<odoo-mcp-odoo-database>",
"ODOO_MCP_ODOO_USERNAME": "<odoo-mcp-odoo-username>",
"ODOO_MCP_ODOO_API_KEY": "<odoo-mcp-odoo-api-key>",
"ODOO_MCP_ALLOWED_COMPANY_IDS": "<odoo-mcp-allowed-company-ids>",
"ODOO_MCP_DEFAULT_COMPANY_ID": "<odoo-mcp-default-company-id>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json.
Configuration
| Variable | Required | Secret | Description |
|---|---|---|---|
| ODOO_MCP_ODOO_URL | yes | — | Base URL of the Odoo Enterprise deployment |
| ODOO_MCP_ODOO_DATABASE | yes | — | Odoo database name |
| ODOO_MCP_ODOO_USERNAME | yes | — | Dedicated Odoo technical-user login |
| ODOO_MCP_ODOO_API_KEY | yes | yes | API key for the dedicated Odoo technical user |
| ODOO_MCP_ALLOWED_COMPANY_IDS | yes | — | Comma-separated authorized Odoo company IDs |
| ODOO_MCP_DEFAULT_COMPANY_ID | yes | — | Default authorized Odoo company ID |
Freshness
Active — last maintenance signal 13d ago. The newest of the signals below sets the band.
Last commit (default branch)
2026-09-27 · 13d ago · GitHub
Latest release
no data · GitHub
Package published
no data · npm/PyPI
Registry entry updated
2026-09-27 · 13d ago · official registry · v0.3.0
FAQ
›How do I install the Odoo MCP server in Claude Code?
Run: claude mcp add odoo-erp -e ODOO_MCP_ODOO_URL='<odoo-mcp-odoo-url>' -e ODOO_MCP_ODOO_DATABASE='<odoo-mcp-odoo-database>' -e ODOO_MCP_ODOO_USERNAME='<odoo-mcp-odoo-username>' -e ODOO_MCP_ODOO_API_KEY='<odoo-mcp-odoo-api-key>' -e ODOO_MCP_ALLOWED_COMPANY_IDS='<odoo-mcp-allowed-company-ids>' -e ODOO_MCP_DEFAULT_COMPANY_ID='<odoo-mcp-default-company-id>' -- uvx odoo-erp-mcp --config '<--config>'. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.
›Does Odoo require an API key?
Yes. It expects ODOO_MCP_ODOO_URL, ODOO_MCP_ODOO_DATABASE, ODOO_MCP_ODOO_USERNAME, ODOO_MCP_ODOO_API_KEY, ODOO_MCP_ALLOWED_COMPANY_IDS, ODOO_MCP_DEFAULT_COMPANY_ID, of which 1 is a secret.
›Can I use Odoo as a remote (hosted) MCP server?
No hosted endpoint is published; it runs locally over stdio.
›Is Odoo in the official MCP registry?
Yes, as io.github.ebmurha/odoo-mcp.
Alternatives to Odoo
Other productivity & office MCP servers.
BrowserActiveA fast, lightweight MCP server that empowers LLMs with browser automation via Puppeteer’s structured accessibility data, featuring optional vision mode for complex visual understanding and flexible, cross-platform configuration.
PlaywrightActivePlaywright browser automation: interact with web pages through structured accessibility snapshots.
BrowserActiveHeadless browser for AI and web automation with a built-in MCP server.
SkyvernActiveAI-powered browser automation — navigate, click, fill forms, and extract data from any website.
SeleniumBaseActiveBrowser automation, testing and bot-detection bypass using SeleniumBase CDP Mode with Chromium, including click-based CAPTCHA solving.
MobileActiveAndroid and iOS app and device automation, development and app scraping on simulators, emulators and physical devices.