MCP Server

io.github.nicolasramos/odoo-mcp MCP Server

Name: io.github.nicolasramos/odoo-mcp MCP Server
Author: io.github.nicolasramos

io.github.nicolasramos/odoo-mcp

Repository Registry

What is the io.github.nicolasramos/odoo-mcp MCP server?

MCP server for Odoo 18 with 38 business tools

How to install io.github.nicolasramos/odoo-mcp

Copy-paste configuration for popular MCP clients.

transport: stdio

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

Environment / auth

ODOO_URL
required
URL of your Odoo instance (e.g., https://yourcompany.odoo.com)
ODOO_DB
required
Name of your Odoo database
ODOO_USERNAME
required
Odoo username for authentication
ODOO_PASSWORD
required
secret
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)

Claude Desktop

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

{
  "mcpServers": {
    "odoo-mcp": {
      "command": "python",
      "args": [
        "odoo-18-mcp-server"
      ],
      "env": {
        "ODOO_URL": "<YOUR_ODOO_URL>",
        "ODOO_DB": "<YOUR_ODOO_DB>",
        "ODOO_USERNAME": "<YOUR_ODOO_USERNAME>",
        "ODOO_PASSWORD": "<YOUR_ODOO_PASSWORD>",
        "ODOO_MCP_DEFAULT_LIMIT": "<YOUR_ODOO_MCP_DEFAULT_LIMIT>",
        "ODOO_MCP_MAX_LIMIT": "<YOUR_ODOO_MCP_MAX_LIMIT>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "odoo-mcp": {
      "command": "python",
      "args": [
        "odoo-18-mcp-server"
      ],
      "env": {
        "ODOO_URL": "<YOUR_ODOO_URL>",
        "ODOO_DB": "<YOUR_ODOO_DB>",
        "ODOO_USERNAME": "<YOUR_ODOO_USERNAME>",
        "ODOO_PASSWORD": "<YOUR_ODOO_PASSWORD>",
        "ODOO_MCP_DEFAULT_LIMIT": "<YOUR_ODOO_MCP_DEFAULT_LIMIT>",
        "ODOO_MCP_MAX_LIMIT": "<YOUR_ODOO_MCP_MAX_LIMIT>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "odoo-mcp": {
      "command": "python",
      "args": [
        "odoo-18-mcp-server"
      ],
      "env": {
        "ODOO_URL": "<YOUR_ODOO_URL>",
        "ODOO_DB": "<YOUR_ODOO_DB>",
        "ODOO_USERNAME": "<YOUR_ODOO_USERNAME>",
        "ODOO_PASSWORD": "<YOUR_ODOO_PASSWORD>",
        "ODOO_MCP_DEFAULT_LIMIT": "<YOUR_ODOO_MCP_DEFAULT_LIMIT>",
        "ODOO_MCP_MAX_LIMIT": "<YOUR_ODOO_MCP_MAX_LIMIT>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "odoo-mcp": {
      "type": "stdio",
      "command": "python",
      "args": [
        "odoo-18-mcp-server"
      ],
      "env": {
        "ODOO_URL": "<YOUR_ODOO_URL>",
        "ODOO_DB": "<YOUR_ODOO_DB>",
        "ODOO_USERNAME": "<YOUR_ODOO_USERNAME>",
        "ODOO_PASSWORD": "<YOUR_ODOO_PASSWORD>",
        "ODOO_MCP_DEFAULT_LIMIT": "<YOUR_ODOO_MCP_DEFAULT_LIMIT>",
        "ODOO_MCP_MAX_LIMIT": "<YOUR_ODOO_MCP_MAX_LIMIT>"
      }
    }
  }
}

Claude Code

claude mcp add odoo-mcp --env ODOO_URL=<YOUR_ODOO_URL> --env ODOO_DB=<YOUR_ODOO_DB> --env ODOO_USERNAME=<YOUR_ODOO_USERNAME> --env ODOO_PASSWORD=<YOUR_ODOO_PASSWORD> --env ODOO_MCP_DEFAULT_LIMIT=<YOUR_ODOO_MCP_DEFAULT_LIMIT> --env ODOO_MCP_MAX_LIMIT=<YOUR_ODOO_MCP_MAX_LIMIT> -- python odoo-18-mcp-server