# MCP Server Odoo (MCP server)

> MCP Server Odoo is an MCP server that enables AI assistants like Claude to interact with Odoo ERP systems. Access business data, search records, create new entries, update existing data, and manage your Odoo instance through natural language. It has 398 GitHub stars, is released under the MPL-2.0 license and runs locally with uvx mcp-server-odoo.

An MCP server that enables AI assistants like Claude to interact with Odoo ERP systems. Access business data, search records, create new entries, update existing data, and manage your Odoo instance through natural language.

## Key facts

| Fact | Value |
|---|---|
| Repository | https://github.com/ivnvxd/mcp-server-odoo |
| GitHub stars | 398 |
| License | MPL-2.0 |
| Language | Python |
| Transport | stdio |
| Packages | pypi: mcp-server-odoo; docker: ghcr.io/ivnvxd/mcp-server-odoo |
| Remote URL | none |
| Needs API key | yes |
| Official | no |
| Works with | Claude Desktop, Claude Code, Cursor, VS Code |
| Category | AI & search |
| Latest release | v0.8.0 (Aug 26, 2026) |
| Last commit | Aug 26, 2026 |

## Install

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mcp-server-odoo": {
      "command": "uvx",
      "args": [
        "mcp-server-odoo"
      ],
      "env": {
        "ODOO_API_KEY": "your-value",
        "ODOO_PASSWORD": "your-value"
      }
    }
  }
}
```

Settings > Developer > Edit Config. macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\. Restart Claude Desktop afterwards.

### Claude Code

```sh
claude mcp add --env ODOO_API_KEY=your-value --env ODOO_PASSWORD=your-value --transport stdio mcp-server-odoo -- uvx mcp-server-odoo
```

### Cursor (.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp-server-odoo": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mcp-server-odoo"
      ],
      "env": {
        "ODOO_API_KEY": "your-value",
        "ODOO_PASSWORD": "your-value"
      }
    }
  }
}
```

Project file; use ~/.cursor/mcp.json to enable it in every project.

### VS Code (.vscode/mcp.json)

```json
{
  "inputs": [
    {
      "type": "promptString",
      "id": "odoo_api_key",
      "description": "ODOO_API_KEY",
      "password": true
    },
    {
      "type": "promptString",
      "id": "odoo_password",
      "description": "ODOO_PASSWORD",
      "password": true
    }
  ],
  "servers": {
    "mcp-server-odoo": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mcp-server-odoo"
      ],
      "env": {
        "ODOO_API_KEY": "${input:odoo_api_key}",
        "ODOO_PASSWORD": "${input:odoo_password}"
      }
    }
  }
}
```

Config formats checked against the official docs on 2026-10-07.

## Environment variables

- `ODOO_URL`: Shown in the README's example configuration.
- `ODOO_API_KEY` (secret): Shown in the README's example configuration.
- `ODOO_DB`: Shown in the README's example configuration.
- `ODOO_USER`: Shown in the README's example configuration.
- `ODOO_PASSWORD` (secret): Shown in the README's example configuration.
- `ODOO_YOLO`: Shown in the README's example configuration.
- `SSL_CERT_FILE`: Shown in the README's example configuration.
- `ODOO_MCP_LOG_LEVEL`: Shown in the README's example configuration.

## Tools

- `search_records`: Search for records in any Odoo model with filters.
- `get_record`: Retrieve a specific record by ID.
- `get_fields`: Describe a model's fields — type, label, required/readonly, relation target, and selection options.
- `get_current_context`: Return the current session context: the connected user, their timezone, the active company plus any other allowed…
- `list_models`: List all models enabled for MCP access.
- `list_resource_templates`: List available resource URI templates and their patterns.
- `create_record`: Create a new record in Odoo.
- `update_record`: Update an existing record.
- `delete_record`: Delete a record from Odoo.
- `post_message`: Post a message to a record's chatter (mail.thread). subtype="note" (default) is an internal log; subtype="comment"…
- `aggregate_records`: Server-side aggregation. Use this whenever the question is "totals/counts/groupings" rather than "list of records" —…
- `call_model_method`: Generic XML-RPC executekw escape hatch — invokes public business methods, for workflow actions not covered by CRUD…

## Similar MCP servers

- [Context7](https://appsgit.com/mcp-servers/context7): Up-to-date code docs for any prompt. (62,752 stars, MIT, needs API key)
- [FunASR](https://appsgit.com/mcp-servers/funasr): Transcribe local audio with FunASR and SenseVoice using private, on-device inference. (20,596 stars, MIT)
- [Bifrost](https://appsgit.com/mcp-servers/bifrost): Fastest enterprise AI gateway (50x faster than LiteLLM) with adaptive load balancer, cluster mode, guardrails, 1000+ models support & <100 µs overhead at 5k RPS. (8,591 stars, Apache-2.0)
- [Honcho](https://appsgit.com/mcp-servers/honcho): Memory that reasons: continual learning for stateful agents. (7,494 stars, AGPL-3.0, needs API key)
- [Semble](https://appsgit.com/mcp-servers/semble): Fast and Accurate Code Search for Agents. (6,185 stars, MIT)
- [Exa](https://appsgit.com/mcp-servers/exa): Connect AI agents to Exa for web search, content fetching, and multi-step research. (5,088 stars, MIT, official)

---

Canonical page: https://appsgit.com/mcp-servers/mcp-server-odoo
Source: appsgit (https://appsgit.com), the app store for github. Data from the GitHub API, refreshed nightly.
Machine access: JSON API https://appsgit.com/api/v1/apps (OpenAPI: https://appsgit.com/openapi.json), MCP server https://mcp.appsgit.com/mcp, full index https://appsgit.com/llms-full.txt.