Skip to main content
Glama
Sign In
odoo-dgoo2308

Odoo XML-RPC MCP Server

by odoo-dgoo2308
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Remote

Odoo XML-RPC MCP Server

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

Features

  • 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

Related MCP server: MCP Server for Odoo

Installation

Global Installation (Desktop MCP Server)

  1. Install globally using npm:

npm install -g .

  1. Add to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "odoo-xmlrpc": {
      "command": "odoo-xmlrpc-mcp-server",
      "args": ["--project", "your_project", "--environment", "your_env"],
      "env": {
        "ODOO_URL": "https://your-odoo.domain.com",
        "ODOO_DATABASE": "your_database",
        "ODOO_USERNAME": "your_username", 
        "ODOO_PASSWORD": "your_password"
      }
    }
  }
}

Local Installation (Claude Code)

  1. Clone or copy this repository to your project directory

  2. Install dependencies:

npm install

  1. Build the project:

npm run build

  1. Create .claude.json in your project root:

{
  "mcp": {
    "servers": {
      "odoo-xmlrpc": {
        "command": "node",
        "args": ["./dist/index.js", "--project", "your_project", "--environment", "your_env"],
        "env": {
          "ODOO_URL": "https://your-odoo.domain.com",
          "ODOO_DATABASE": "your_database", 
          "ODOO_USERNAME": "your_username",
          "ODOO_PASSWORD": "your_password"
        }
      }
    }
  }
}

Development

For development, you can run directly with tsx:

npm run dev -- --project your_project --environment your_env

Configuration

Config File Method

Create a configuration file at ~/.odoo_config/<project>_<environment>.conf:

[odoo]
url = https://your-odoo.domain.com
database = your_database
username = your_username
password = your_password

Environment Variables (Priority)

Set these environment variables (they take priority over config files):

  • ODOO_URL

  • ODOO_DATABASE

  • ODOO_USERNAME

  • ODOO_PASSWORD

Usage

Available Tools

odoo_search

Search for records in an Odoo model.

{
  "model": "res.partner",
  "domain": [["is_company", "=", true]],
  "limit": 10
}

odoo_read

Read specific records by ID.

{
  "model": "res.partner", 
  "ids": [1, 2, 3],
  "fields": ["name", "email", "phone"]
}

odoo_create

Create a new record.

{
  "model": "res.partner",
  "values": {
    "name": "New Company",
    "is_company": true,
    "email": "info@newcompany.com"
  }
}

odoo_write

Update existing records.

{
  "model": "res.partner",
  "ids": [123], 
  "values": {
    "phone": "+1-555-0123"
  }
}

odoo_unlink

Delete records.

{
  "model": "res.partner",
  "ids": [456]
}

odoo_search_count

Count records matching a domain.

{
  "model": "res.partner",
  "domain": [["is_company", "=", true]]
}

odoo_fields_get

Get field definitions for a model.

{
  "model": "res.partner",
  "fields": ["name", "email"]
}

odoo_search_read

Search and read in one operation.

{
  "model": "res.partner",
  "domain": [["is_company", "=", true]],
  "fields": ["name", "email"],
  "limit": 5
}

Development

Requirements

  • Node.js 18+

  • npm or yarn

Running Locally

npm run dev -- --project myproject --environment staging

Building

npm run build

Testing Connection

npm run dev -- --project idp --environment staging

License

MIT License

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • Odoo MCP Server

    sebastianPhoenix
    A
    license
    Not graded
    quality
    D
    maintenance
    Enables AI assistants to interact with Odoo ERP systems through XML-RPC communication. Provides access to Odoo models, records, methods, and data structures for comprehensive ERP integration.
    2
    MIT

  • MCP Server for Odoo

    AlejandroLaraPolanco
    A
    license
    Not graded
    quality
    Not graded
    maintenance
    Enables AI assistants to interact with Odoo ERP systems through natural language to search records, create entries, update data, and manage business operations. Supports secure authentication and configurable access controls for production environments.
    Mozilla Public 2.0

  • MCP Server for Odoo

    elevateinformatics
    A
    license
    Not graded
    quality
    C
    maintenance
    Enables AI assistants to interact with Odoo ERP systems through natural language, allowing users to search, create, update, and manage business records like customers, products, and invoices across any Odoo instance.
    21 PyPI
    1
    Mozilla Public 2.0

  • MCP Odoo Server

    malvernbright
    A
    license
    Not graded
    quality
    D
    maintenance
    Enables AI assistants to interact with Odoo databases via XML-RPC and JSON-RPC for performing CRUD operations and managing modules. It supports advanced features like domain-based searching, field metadata inspection, and administrative task execution.
    6 npm
    MIT