Odoo 18 MCP Server
by nicolasramosio.github.nicolasramos/odoo-mcpv1.0.1
MCP server for Odoo 18 with 38 business tools
context tax
queued
security
queued
cold start
queued
freshness
Maintained2mo ago
Install Odoo 18 MCP server
Install in Claude Code
claude mcp add odoo-18 -e ODOO_URL='<odoo-url>' -e ODOO_DB='<odoo-db>' -e ODOO_USERNAME='<odoo-username>' -e ODOO_PASSWORD='<odoo-password>' -- uvx odoo-18-mcp-serverInstall in Cursor
{
"mcpServers": {
"odoo-18": {
"command": "uvx",
"args": [
"odoo-18-mcp-server"
],
"env": {
"ODOO_URL": "<odoo-url>",
"ODOO_DB": "<odoo-db>",
"ODOO_USERNAME": "<odoo-username>",
"ODOO_PASSWORD": "<odoo-password>"
}
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).
Install in Claude Desktop
{
"mcpServers": {
"odoo-18": {
"command": "uvx",
"args": [
"odoo-18-mcp-server"
],
"env": {
"ODOO_URL": "<odoo-url>",
"ODOO_DB": "<odoo-db>",
"ODOO_USERNAME": "<odoo-username>",
"ODOO_PASSWORD": "<odoo-password>"
}
}
}
}Settings → Developer → Edit Config (claude_desktop_config.json), then restart.
Install in VS Code
{
"servers": {
"odoo-18": {
"type": "stdio",
"command": "uvx",
"args": [
"odoo-18-mcp-server"
],
"env": {
"ODOO_URL": "<odoo-url>",
"ODOO_DB": "<odoo-db>",
"ODOO_USERNAME": "<odoo-username>",
"ODOO_PASSWORD": "<odoo-password>"
}
}
}
}Add to .vscode/mcp.json in your workspace.
Install in Windsurf
{
"mcpServers": {
"odoo-18": {
"command": "uvx",
"args": [
"odoo-18-mcp-server"
],
"env": {
"ODOO_URL": "<odoo-url>",
"ODOO_DB": "<odoo-db>",
"ODOO_USERNAME": "<odoo-username>",
"ODOO_PASSWORD": "<odoo-password>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json.
Configuration
| Variable | Required | Secret | Description |
|---|---|---|---|
| ODOO_URL | yes | — | URL of your Odoo instance (e.g., https://yourcompany.odoo.com) |
| ODOO_DB | yes | — | Name of your Odoo database |
| ODOO_USERNAME | yes | — | Odoo username for authentication |
| ODOO_PASSWORD | yes | yes | Odoo password for authentication |
| ODOO_MCP_DEFAULT_LIMIT | — | — | Default limit for search results (default: 50) |
| ODOO_MCP_MAX_LIMIT | — | — | Maximum limit for search results (default: 80) |
Freshness
Maintained — last maintenance signal 2mo ago. The newest of the signals below sets the band.
Last commit (default branch)
2026-08-10 · 2mo ago · GitHub
Latest release
2026-04-25 · 6mo ago · GitHub · v2.2.0
Package published
no data · npm/PyPI
Registry entry updated
2026-04-03 · 6mo ago · official registry · v1.0.1
FAQ
›How do I install the Odoo 18 MCP server in Claude Code?
Run: claude mcp add odoo-18 -e ODOO_URL='<odoo-url>' -e ODOO_DB='<odoo-db>' -e ODOO_USERNAME='<odoo-username>' -e ODOO_PASSWORD='<odoo-password>' -- uvx odoo-18-mcp-server. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.
›Does Odoo 18 require an API key?
Yes. It expects ODOO_URL, ODOO_DB, ODOO_USERNAME, ODOO_PASSWORD, of which 1 is a secret.
›Can I use Odoo 18 as a remote (hosted) MCP server?
No hosted endpoint is published; it runs locally over stdio.
›Is Odoo 18 in the official MCP registry?
Yes, as io.github.nicolasramos/odoo-mcp.