Model Access

1. Go to Settings > MCP Server > Enabled Models
2. Add models you want to expose (e.g., res.partner, product.product)
3. Configure permissions for each model: - Read access - Write access - Create access - Delete access

API Key Setup

1. Navigate to Settings > Users & Companies > Users
2. Select the user for MCP access
3. Go to API Keys tab
4. Generate a new API key with appropriate scope
5. Use this key in your MCP client configuration

Client Setup

After installing the module and generating an API key, configure your AI assistant:

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "odoo": {
      "command": "uvx",
      "args": ["mcp-server-odoo"],
      "env": {
        "ODOO_URL": "https://your-odoo-instance.com",
        "ODOO_API_KEY": "your-api-key-here"
      }
    }
  }
}

Cursor

Add to ~/.cursor/mcp_settings.json:

{
  "mcpServers": {
    "odoo": {
      "command": "uvx",
      "args": ["mcp-server-odoo"],
      "env": {
        "ODOO_URL": "https://your-odoo-instance.com",
        "ODOO_API_KEY": "your-api-key-here"
      }
    }
  }
}

Claude Code

Run the following command to add the Odoo MCP server:

claude mcp add odoo \
  -e ODOO_URL=https://your-odoo-instance.com \
  -e ODOO_API_KEY=your-api-key-here \
  -- uvx ivnvxd/mcp-server-odoo

Environment Variables

The MCP client requires one of the following authentication methods:

API Key Authentication (Recommended):

• ODOO_URL: Your Odoo instance URL (e.g., https://mycompany.odoo.com)
• ODOO_API_KEY: The API key generated in the previous step

Username/Password Authentication:

• ODOO_URL: Your Odoo instance URL (e.g., https://mycompany.odoo.com)
• ODOO_USER: Your Odoo username
• ODOO_PASSWORD: Your Odoo password

Optional Variables:

• ODOO_DB: Database name (auto-detected if not specified)

Security Groups

The module creates two security groups:

• MCP Administrator: Can configure MCP settings and manage enabled models
• MCP User: Can access MCP-enabled models based on configured permissions

REST API

• /mcp/health - Health check
• /mcp/system/info - System information
• /mcp/auth/validate - API key validation
• /mcp/models - List enabled models
• /mcp/models/{model}/access - Check model permissions

XML-RPC API

• /mcp/xmlrpc/common - Authentication
• /mcp/xmlrpc/db - Database operations
• /mcp/xmlrpc/object - Model operations

Common Issues

Module Not Installing - Check that all dependencies are satisfied - Ensure Odoo 18.0 is being used

API Key Not Working - Verify the key is active in user settings - Check user has appropriate MCP permissions - Ensure correct API key scope

Model Access Denied - Confirm model is in enabled models list - Check operation permissions for the model - Verify user's security group membership