Odoo Rust MCP - Homebrew Tap

⚡ Quick Start

Terminal

                    # Install in one command
brew tap rachmataditiya/odoo-rust-mcp && brew install rust-mcp
                

Or install directly:

Terminal

brew install rachmataditiya/odoo-rust-mcp/rust-mcp

🚀 Getting Started

1

Install the package

Run the brew install command above

2

Configure your Odoo credentials

Edit the env file with your Odoo URL, database, and API key

Terminal

nano ~/.config/odoo-rust-mcp/env

3

Start the service

Run as a background service with brew services

Terminal

brew services start rust-mcp

📁 What Gets Installed

Component	Location
Binary	/opt/homebrew/bin/rust-mcp
Service wrapper	/opt/homebrew/bin/rust-mcp-service
Default configs	/opt/homebrew/share/odoo-rust-mcp/
User configs	~/.config/odoo-rust-mcp/
Service logs	/opt/homebrew/var/log/rust-mcp.log

⚙️ Configuration

🔑

Odoo 19+ (API Key)

Set ODOO_URL, ODOO_DB, and ODOO_API_KEY in your env file

👤

Odoo < 19 (Password)

Set ODOO_URL, ODOO_DB, ODOO_VERSION, ODOO_USERNAME, and ODOO_PASSWORD

                    ~/.config/odoo-rust-mcp/env
                

                    # Odoo 19+ (API Key authentication)
ODOO_URL=https://mycompany.odoo.com
ODOO_DB=mydb
ODOO_API_KEY=your_api_key_here

# Optional: MCP Authentication for HTTP transport
# MCP_AUTH_TOKEN=your-secure-token
                

🖥️ Cursor IDE Configuration

Add to ~/.cursor/mcp.json:

Using HTTP (when service is running)

                    {
  "mcpServers": {
    "odoo": {
      "url": "http://127.0.0.1:8787/mcp"
    }
  }
}
                

                    Using stdio (recommended for Cursor/Claude Desktop/Windsurf)
                

                    {
  "mcpServers": {
    "odoo": {
      "command": "/opt/homebrew/bin/rust-mcp",
      "args": ["--transport", "stdio"]
    }
  }
}
                

v0.2.5+: The binary automatically loads config from ~/.config/odoo-rust-mcp/env. You can use rust-mcp directly (no shell wrapper needed). This ensures compatibility with all MCP clients including Windsurf.

Multi-instance support: Use ODOO_INSTANCES_JSON env var pointing to a JSON file for readable multi-instance configuration.

🛠️ Service Commands

                    Managing the service
                

                    # Start service
brew services start rust-mcp

# Stop service
brew services stop rust-mcp

# Restart after config changes
brew services restart rust-mcp

# Check status
brew services list

# View logs
tail -f /opt/homebrew/var/log/rust-mcp.log
                

Service endpoint: http://127.0.0.1:8787/mcp

🗑️ Uninstall

                    Terminal
                

                    # Stop service first
brew services stop rust-mcp

# Uninstall
brew uninstall rust-mcp

# Remove tap (optional)
brew untap rachmataditiya/odoo-rust-mcp

# Remove config files (optional)
rm -rf ~/.config/odoo-rust-mcp
                