Xml Rpc Odoo MCP Server

MCP Server for Odoo XML-RPC integration

Local serverstdio

What is the Xml Rpc Odoo MCP MCP server?

Xml rpc odoo mcp mcp server lets Claude, Cursor and other MCP clients work with Xml Rpc Odoo MCP directly. MCP Server for Odoo XML-RPC integration.

What Xml Rpc Odoo MCP does

A Model Context Protocol (MCP) server that provides tools for interacting with Odoo via XML-RPC.

Key capabilities

  • Connect to any Odoo instance via XML-RPC
  • Configurable project and environment parameters
  • Environment variable support with priority over config files
  • Complete set of Odoo operations: search, read, create, write, delete
  • Integration with Claude Desktop and Claude Code

Tools it exposes

Once connected, the assistant can call these 11 tools directly:

  • Development — For development, you can run directly with tsx: bash npm run dev -- --project your_project --environment your_env
  • odoo_search — Search for records in an Odoo model. json { "model": "res.partner", "domain": [["is_company", "=", true]], "limit": 10 }
  • odoo_read — Read specific records by ID. json { "model": "res.partner", "ids": [1, 2, 3], "fields": ["name", "email", "phone"] }
  • odoo_create — Create a new record. json { "model": "res.partner", "values": { "name": "New Company", "is_company": true, "email": "info@newcompany.com" } }
  • odoo_write — Update existing records. json { "model": "res.partner", "ids": [123], "values": { "phone": "+1-555-0123" } }
  • odoo_unlink — Delete records. json { "model": "res.partner", "ids": [456] }
  • odoo_search_count — Count records matching a domain. json { "model": "res.partner", "domain": [["is_company", "=", true]] }
  • odoo_fields_get — Get field definitions for a model. json { "model": "res.partner", "fields": ["name", "email"] }
  • odoo_search_read — Search and read in one operation. json { "model": "res.partner", "domain": [["is_company", "=", true]], "fields": ["name", "email"], "limit": 5 }
  • Requirements — The Requirements tool exposed by this server
  • Building — The Building tool exposed by this server

Installing the xml rpc odoo mcp mcp server

Setup follows the standard MCP pattern: clone or install the server, then register it in your client's configuration file and restart the client. The configuration snippets on this page cover Claude Desktop, Claude Code and Cursor.

Configuration

Before the server will start you need to supply 4 environment variables: ODOO_URL, ODOO_DATABASE, ODOO_USERNAME, ODOO_PASSWORD. Keep credentials in your client's env block or a secrets manager rather than committing them.

Requirements

  • Node.js 18+ - npm or yarn

Where it fits

Communication servers earn their keep on volume — summarising channels and threads that would otherwise cost you an hour of scrollback. Xml Rpc Odoo MCP sits in that group, and the shape of its toolset — Development, odoo_search, odoo_read among others — tells you what it is really for. Worth comparing against the other communication servers in this directory before you commit to one, since several overlap in scope but differ sharply in setup cost and permissions.

Practical notes

  • This server runs locally, so it operates with whatever access your machine and its credentials already have. Scope that deliberately rather than by default.
  • It will not start until its required credentials are present, so set those before wondering why the tools never appear.
  • With 11 tools exposed, expect a noticeable bump in prompt size — disable it in projects that never use Xml Rpc Odoo MCP.
  • Maintained by v-odoo-testing.
  • MCP clients ask for confirmation before each tool call by default. Keep that on while you learn what the xml rpc odoo mcp mcp server actually does with your data.
  • Every entry in this directory is reviewed by hand before it goes live, and details are checked against the project's own documentation.

Available tools

ToolWhat it does
DevelopmentFor development, you can run directly with tsx: bash npm run dev -- --project your_project --environment your_env
odoo_searchSearch for records in an Odoo model. json { "model": "res.partner", "domain": [["is_company", "=", true]], "limit": 10 }
odoo_readRead specific records by ID. json { "model": "res.partner", "ids": [1, 2, 3], "fields": ["name", "email", "phone"] }
odoo_createCreate a new record. json { "model": "res.partner", "values": { "name": "New Company", "is_company": true, "email": "info@newcompany.com" } }
odoo_writeUpdate existing records. json { "model": "res.partner", "ids": [123], "values": { "phone": "+1-555-0123" } }
odoo_unlinkDelete records. json { "model": "res.partner", "ids": [456] }
odoo_search_countCount records matching a domain. json { "model": "res.partner", "domain": [["is_company", "=", true]] }
odoo_fields_getGet field definitions for a model. json { "model": "res.partner", "fields": ["name", "email"] }
odoo_search_readSearch and read in one operation. json { "model": "res.partner", "domain": [["is_company", "=", true]], "fields": ["name", "email"], "limit": 5 }
RequirementsThe Requirements tool exposed by this server.
BuildingThe Building tool exposed by this server.

Configuration

  • Node.js 18+ - npm or yarn
VariableDescriptionRequired
ODOO_URLEndpoint or connection string the server talks to.Yes
ODOO_DATABASEConfiguration value read at startup.Optional
ODOO_USERNAMEConfiguration value read at startup.Optional
ODOO_PASSWORDConfiguration value read at startup.Optional

Example prompts to try

  • Use Xml Rpc Odoo MCP to Development.
  • Use Xml Rpc Odoo MCP to odoo search.
  • Use Xml Rpc Odoo MCP to odoo read.

Frequently asked questions

It connects Xml Rpc Odoo MCP to MCP-compatible AI assistants such as Claude and Cursor, exposing 11 tools (Development, odoo_search, odoo_read, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Xml Rpc Odoo MCP directly.