odoo-mcp-multi 0.2.5

MCP Server for connecting Claude/Cursor to multiple Odoo instances

odoo-mcp-multi

MCP Server for connecting MCP clients (Antigravity, Claude Desktop, Cursor, VS Code) to multiple Odoo instances.

🌟 Features

• Multi-profile management: Store credentials for multiple environments (prod, staging, dev).
• Secure by default: Credentials safely stored in ~/.config/odoo-mcp/ (600 permissions).
• Multi-protocol Support: JSON-RPC (8.0+), JSON2 (19.0+), XML-RPC (legacy) natively auto-detected.
• 10 Native MCP tools: search_read, write, create, export_records, import_records, execute_kw, list_models, list_fields, list_available_profiles, get_version.
• Integrated CLI: Powerful command-line tool for profile and server management.

🚀 Installation & Quick Start

# Install package
pip install .

# 1. Add your Odoo instance credentials
odoo-mcp add-profile

# 2. Start MCP server (Optional: lock to a specific profile with -p)
odoo-mcp run

💻 CLI Operations

You can manage all configuration directly from your terminal. Use odoo-mcp [COMMAND] --help for specific flags.

• odoo-mcp add-profile: Interactive wizard to register a new instance.
• odoo-mcp list-profiles: Displays all configured profiles.
• odoo-mcp edit-profile NAME: Modify credentials, URLs, or database of an existing profile.
• odoo-mcp remove-profile NAME: Deletes a profile.
• odoo-mcp test -p NAME: Tests live connection to confirm credentials are working.
• odoo-mcp run: Starts the MCP server process.

⚙️ MCP Client Configuration

The server gracefully handles multiple Odoo instances simultaneously. You only need to declare one server definition in your AI client. You can optionally force a single fallback using ["run", "-p", "prod"].

Global Configuration Block:

{
  "mcpServers": {
    "odoo": {
      "command": "odoo-mcp",
      "args": ["run"]
    }
  }
}

Add the block above to your respective client configuration file:

• Antigravity: ~/.gemini/antigravity/mcp_config.json
• Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json
• Cursor: .cursor/mcp.json
• VS Code: .vscode/mcp.json

🛠 Available MCP Tools

All tools accept an optional profile string parameter to dynamically select the target Odoo environment.

• list_available_profiles: Discovers the local environments available.
• search_read: Queries records from any model based on domains.
• write: Updates values on existing records.
• create: Instantiates new records in a model.
• export_records: Native Odoo export_data returning a clean array of dicts (Useful for relational lookup and retrieving XML External IDs id).
• import_records: Native Odoo load bulk processor. Updates existing records if External IDs are provided, or creates new ones.
• execute_kw: Executes arbitrary backend methods (action_confirm, send, etc).
• list_models / list_fields: Discovers the system's schema architecture.
• get_version: Retrieves server version mapping.

💡 Usage Examples in Claude

"List all contacts containing 'John' in their name"

search_read(model="res.partner", domain="[('name', 'ilike', 'John')]", fields="name,email,phone")

"Create a new contact named Alice with email [e-mail]"

create(model="res.partner", values='{"name": "Alice", "email": "[e-mail]"}')

"Confirm the sales order with ID 42"

execute_kw(model="sale.order", method="action_confirm", args="[[42]]")

"What fields does the invoice model have?"

list_fields(model="account.move")

"Export the name and external ID of all active partners"

export_records(model="res.partner", domain="[('active', '=', True)]", fields="id,name")

"Update the phone number of the partner with external ID 'base.res_partner_1' and create a new partner"

import_records(model="res.partner", fields="id,name,phone", rows='[{"id": "base.res_partner_1", "name": "Existing Partner", "phone": "12345"}, {"name": "New Partner", "phone": "67890"}]')

🛡 Security & Development

• Credentials securely written to ~/.config/odoo-mcp/profiles.json without raw logging.
• Development mode requires pip install -e ".[dev]". Code standard is heavily enforced by ruff.