Skip to content
appsgit

MCP Server Odoo

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.

github.com/ivnvxd/mcp-server-odoo (opens in a new tab)

Install MCP Server Odoo

Generated from the server's published package. Replace your-value with your own values.

Claude Desktop

claude_desktop_config.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

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
{
  "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
{
  "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 Oct 7, 2026: modelcontextprotocol.io (opens in a new tab), code.claude.com (opens in a new tab), cursor.com (opens in a new tab), code.visualstudio.com (opens in a new tab).

Environment variables

Variables the server reads at startup.

NameRequiredDescription
ODOO_URLNoShown in the README's example configuration.
ODOO_API_KEYsecretNoShown in the README's example configuration.
ODOO_DBNoShown in the README's example configuration.
ODOO_USERNoShown in the README's example configuration.
ODOO_PASSWORDsecretNoShown in the README's example configuration.
ODOO_YOLONoShown in the README's example configuration.
SSL_CERT_FILENoShown in the README's example configuration.
ODOO_MCP_LOG_LEVELNoShown in the README's example configuration.

Tools (12)

Parsed from the Tools section of the README; check the repository for the current list.

  • 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…

About 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.

  • mcp
  • mcp-server
  • odoo
  • ai
  • erp
  • llm
  • model-context-protocol
  • mcp-servers
  • odoo-mcp

FAQ

MCP Server Odoo FAQ

Still curious? Email info@appsgit.com.

What is MCP Server Odoo?

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. The source code is at github.com/ivnvxd/mcp-server-odoo.

How do I install the MCP Server Odoo MCP server?

Add the command uvx mcp-server-odoo to your MCP client: put it in claude_desktop_config.json for Claude Desktop, run claude mcp add for Claude Code, or add it to .cursor/mcp.json (Cursor) or .vscode/mcp.json (VS Code). The snippets on this page are ready to paste.

Is MCP Server Odoo free?

The server is open source under the MPL-2.0 license, so running it is free. It needs credentials (ODOO_API_KEY and ODOO_PASSWORD) for the service it connects to, which may require a paid account.

Is MCP Server Odoo actively maintained?

The most recent commit was on Aug 26, 2026. The latest release is v0.8.0, published Aug 26, 2026. appsgit only lists MCP servers with a commit in the last six months and re-checks every server daily.