io.github.singleflo/odoo-assistant MCP Server

Name: io.github.singleflo/odoo-assistant MCP Server
Author: io.github.singleflo

io.github.singleflo/odoo-assistant

Repository Registry

What is the io.github.singleflo/odoo-assistant MCP server?

Odoo virtual employee via MCP: query, create, modify records, workflows, PDFs, and activities.

How to install io.github.singleflo/odoo-assistant

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

ODOO_BASE_URL
required
Your Odoo instance URL (e.g. http://localhost:8069)
ODOO_DB
Odoo database name. Optional: discovered automatically when the instance serves exactly one database; required when it serves several (the error names them).
ODOO_USER
Odoo login username. Optional: omitted, the login is discovered from the API key.
ODOO_API_KEY
required
secret
Odoo API key (Odoo 14+ required). Generate under Preferences / My Profile > Account Security > New API Key. Passwords are not accepted.
ODOO_MCP_MAX_LEVEL
Safety ceiling 0-5, default 3 (state transitions allowed, destructive ops blocked). See server_safety.py.
ODOO_MCP_PROTECTED_HOSTS
Comma-separated hosts this server refuses to WRITE to (requires ODOO_ALLOW_PROD_WRITE=yes to override). Empty by default: protection is the operator's opt-in, no host is baked in.

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "odoo-assistant": {
      "command": "uvx",
      "args": [
        "odoo-assistant"
      ],
      "env": {
        "ODOO_BASE_URL": "<YOUR_ODOO_BASE_URL>",
        "ODOO_DB": "<YOUR_ODOO_DB>",
        "ODOO_USER": "<YOUR_ODOO_USER>",
        "ODOO_API_KEY": "<YOUR_ODOO_API_KEY>",
        "ODOO_MCP_MAX_LEVEL": "<YOUR_ODOO_MCP_MAX_LEVEL>",
        "ODOO_MCP_PROTECTED_HOSTS": "<YOUR_ODOO_MCP_PROTECTED_HOSTS>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "odoo-assistant": {
      "command": "uvx",
      "args": [
        "odoo-assistant"
      ],
      "env": {
        "ODOO_BASE_URL": "<YOUR_ODOO_BASE_URL>",
        "ODOO_DB": "<YOUR_ODOO_DB>",
        "ODOO_USER": "<YOUR_ODOO_USER>",
        "ODOO_API_KEY": "<YOUR_ODOO_API_KEY>",
        "ODOO_MCP_MAX_LEVEL": "<YOUR_ODOO_MCP_MAX_LEVEL>",
        "ODOO_MCP_PROTECTED_HOSTS": "<YOUR_ODOO_MCP_PROTECTED_HOSTS>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "odoo-assistant": {
      "command": "uvx",
      "args": [
        "odoo-assistant"
      ],
      "env": {
        "ODOO_BASE_URL": "<YOUR_ODOO_BASE_URL>",
        "ODOO_DB": "<YOUR_ODOO_DB>",
        "ODOO_USER": "<YOUR_ODOO_USER>",
        "ODOO_API_KEY": "<YOUR_ODOO_API_KEY>",
        "ODOO_MCP_MAX_LEVEL": "<YOUR_ODOO_MCP_MAX_LEVEL>",
        "ODOO_MCP_PROTECTED_HOSTS": "<YOUR_ODOO_MCP_PROTECTED_HOSTS>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "odoo-assistant": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "odoo-assistant"
      ],
      "env": {
        "ODOO_BASE_URL": "<YOUR_ODOO_BASE_URL>",
        "ODOO_DB": "<YOUR_ODOO_DB>",
        "ODOO_USER": "<YOUR_ODOO_USER>",
        "ODOO_API_KEY": "<YOUR_ODOO_API_KEY>",
        "ODOO_MCP_MAX_LEVEL": "<YOUR_ODOO_MCP_MAX_LEVEL>",
        "ODOO_MCP_PROTECTED_HOSTS": "<YOUR_ODOO_MCP_PROTECTED_HOSTS>"
      }
    }
  }
}

Claude Code

claude mcp add odoo-assistant --env ODOO_BASE_URL=<YOUR_ODOO_BASE_URL> --env ODOO_DB=<YOUR_ODOO_DB> --env ODOO_USER=<YOUR_ODOO_USER> --env ODOO_API_KEY=<YOUR_ODOO_API_KEY> --env ODOO_MCP_MAX_LEVEL=<YOUR_ODOO_MCP_MAX_LEVEL> --env ODOO_MCP_PROTECTED_HOSTS=<YOUR_ODOO_MCP_PROTECTED_HOSTS> -- uvx odoo-assistant