Connects agents to Odoo 16-19 with reads, approval-gated writes, multi-instance support, and diagnostics, migration and audit tools.
Setup
Choose your client, copy the config, then fill in any required environment variables.
claude mcp add odoo --env ODOO_URL='<ODOO_URL>' --env ODOO_DB='<ODOO_DB>' --env ODOO_USERNAME='<ODOO_USERNAME>' --env ODOO_PASSWORD='<ODOO_PASSWORD>' -- uvx odoo-mcp~/.codex/config.toml
[mcp_servers.odoo]
command = "uvx"
args = ["odoo-mcp"]
env = { ODOO_URL = "<ODOO_URL>", ODOO_DB = "<ODOO_DB>", ODOO_USERNAME = "<ODOO_USERNAME>", ODOO_PASSWORD = "<ODOO_PASSWORD>" }
# codex mcp add odoo --env ODOO_URL='<ODOO_URL>' --env ODOO_DB='<ODOO_DB>' --env ODOO_USERNAME='<ODOO_USERNAME>' --env ODOO_PASSWORD='<ODOO_PASSWORD>' -- uvx odoo-mcp~/.cursor/mcp.json
{
"mcpServers": {
"odoo": {
"command": "uvx",
"args": [
"odoo-mcp"
],
"env": {
"ODOO_URL": "<ODOO_URL>",
"ODOO_DB": "<ODOO_DB>",
"ODOO_USERNAME": "<ODOO_USERNAME>",
"ODOO_PASSWORD": "<ODOO_PASSWORD>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"odoo": {
"type": "stdio",
"command": "uvx",
"args": [
"odoo-mcp"
],
"env": {
"ODOO_URL": "<ODOO_URL>",
"ODOO_DB": "<ODOO_DB>",
"ODOO_USERNAME": "<ODOO_USERNAME>",
"ODOO_PASSWORD": "<ODOO_PASSWORD>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"odoo": {
"command": "uvx",
"args": [
"odoo-mcp"
],
"env": {
"ODOO_URL": "<ODOO_URL>",
"ODOO_DB": "<ODOO_DB>",
"ODOO_USERNAME": "<ODOO_USERNAME>",
"ODOO_PASSWORD": "<ODOO_PASSWORD>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"odoo": {
"command": "uvx",
"args": [
"odoo-mcp"
],
"env": {
"ODOO_URL": "<ODOO_URL>",
"ODOO_DB": "<ODOO_DB>",
"ODOO_USERNAME": "<ODOO_USERNAME>",
"ODOO_PASSWORD": "<ODOO_PASSWORD>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"odoo": {
"command": "uvx",
"args": [
"odoo-mcp"
],
"env": {
"ODOO_URL": "<ODOO_URL>",
"ODOO_DB": "<ODOO_DB>",
"ODOO_USERNAME": "<ODOO_USERNAME>",
"ODOO_PASSWORD": "<ODOO_PASSWORD>"
}
}
}
}Environment variables
ODOO_URLODOO_DBODOO_USERNAMEODOO_PASSWORD
Replace the placeholders with your own credentials and keep them out of version control.