odoo-sh-mcp

MCP server for Odoo SH that gives Claude Code full access to your Odoo instance via XML-RPC: inspect the ORM, read and write business records, manage modules, and tail server logs.

What it does

Claude Code (your machine)
       ↓ MCP protocol (stdio)
odoo-sh-mcp (Python, local)
       ↓ XML-RPC              ↓ SSH / SFTP
Odoo SH (remote instance) ←──────────────

Two transport layers:

• XML-RPC — ORM introspection, records, modules, logs (no SSH needed)
• SSH / SFTP — upload files directly to ~/src/user/, run odoo-update, restart services, tail logs

Tools

Tier 1 — ORM introspection

Tier 2 — View inspection

Tier 3 — Local scaffold (no Odoo connection)

Tier 4 — Module management

Tier 5 — Logs

Tier 6 — SSH / Odoo.sh direct access

Installation

# With uv (recommended)
uvx odoo-sh-mcp

# Or with pip
pip install odoo-sh-mcp

Configuration

Single instance (XML-RPC only)

claude mcp add odoo-mycompany uvx odoo-sh-mcp \
  -e ODOO_URL=https://mycompany.odoo.com \
  -e ODOO_DB=mycompany \
  -e ODOO_API_KEY=your_key_here \
  -e ODOO_USERNAME=you@mycompany.com

Single instance (XML-RPC + SSH)

Includes Tier 6 SSH tools for direct file upload and server commands:

claude mcp add odoo-mycompany uvx odoo-sh-mcp \
  -e ODOO_URL=https://mycompany.odoo.com \
  -e ODOO_DB=mycompany \
  -e ODOO_API_KEY=your_key_here \
  -e ODOO_USERNAME=you@mycompany.com \
  -e ODOO_SH_SSH_HOST=mycompany-main-staging-12345678.dev.odoo.com \
  -e ODOO_SH_SSH_USER=12345678 \
  -e ODOO_SH_SSH_KEY=~/.ssh/id_ed25519

Multi-instance

Run once per instance:

claude mcp add odoo-company-a uvx odoo-sh-mcp \
  -e ODOO_URL=https://company-a.odoo.com \
  -e ODOO_DB=company-a \
  -e ODOO_API_KEY=xxx \
  -e ODOO_USERNAME=you@company-a.com

claude mcp add odoo-company-b uvx odoo-sh-mcp \
  -e ODOO_URL=https://company-b.odoo.com \
  -e ODOO_DB=company-b \
  -e ODOO_API_KEY=yyy \
  -e ODOO_USERNAME=you@company-b.com

Or edit .claude/mcp.json directly:

{
  "mcpServers": {
    "odoo-company-a": {
      "command": "uvx",
      "args": ["odoo-sh-mcp"],
      "env": {
        "ODOO_URL": "https://company-a.odoo.com",
        "ODOO_DB": "company-a",
        "ODOO_API_KEY": "xxx",
        "ODOO_USERNAME": "you@company-a.com",
        "ODOO_SH_SSH_HOST": "company-a-main-staging-XXXXX.dev.odoo.com",
        "ODOO_SH_SSH_USER": "XXXXX",
        "ODOO_SH_SSH_KEY": "~/.ssh/id_ed25519"
      }
    },
    "odoo-company-b": {
      "command": "uvx",
      "args": ["odoo-sh-mcp"],
      "env": {
        "ODOO_URL": "https://company-b.odoo.com",
        "ODOO_DB": "company-b",
        "ODOO_API_KEY": "yyy",
        "ODOO_USERNAME": "you@company-b.com",
        "ODOO_SH_SSH_HOST": "company-b-main-staging-YYYYY.dev.odoo.com",
        "ODOO_SH_SSH_USER": "YYYYY",
        "ODOO_SH_SSH_KEY": "~/.ssh/id_ed25519"
      }
    }
  }
}

Environment variables

*API keys available in Odoo 14+. For older versions use ODOO_USERNAME + ODOO_PASSWORD.

SSH setup (Tier 6 tools)

SSH tools let Claude upload files and run commands directly on the Odoo.sh server, bypassing git commits for fast iteration.

1. Generate an SSH key (if you don't have one)

ssh-keygen -t ed25519 -C "your-name-odoo-sh"

ssh-keygen -t ed25519 -C "your-name-odoo-sh"

ODOO_SH_SSH_KEY=C:/Users/YourName/.ssh/id_ed25519

2. Add your public key to Odoo.sh

Go to https://www.odoo.sh → click your avatar (top right) → Change My Profile → SSH Keys → paste the output of:

# macOS / Linux
cat ~/.ssh/id_ed25519.pub

# Windows (PowerShell)
Get-Content "$env:USERPROFILE\.ssh\id_ed25519.pub"

Odoo.sh only accepts ssh-rsa and ssh-ed25519 keys.

3. Load your key into the SSH agent

ssh-add --apple-use-keychain ~/.ssh/id_ed25519

eval "$(ssh-agent -s)"
ssh-add ~/.ssh/id_ed25519

Set-Service -Name ssh-agent -StartupType Automatic
Start-Service ssh-agent
ssh-add "$env:USERPROFILE\.ssh\id_ed25519"

4. Find your branch SSH host

In the Odoo.sh dashboard, click your branch → Connect → copy the SSH command. It looks like:

ssh 12345678@mycompany-main-staging-12345678.dev.odoo.com

The number before @ is the ODOO_SH_SSH_USER, the hostname after is ODOO_SH_SSH_HOST.

5. Add to your .env or MCP config

ODOO_SH_SSH_HOST=mycompany-main-staging-12345678.dev.odoo.com
ODOO_SH_SSH_USER=12345678
ODOO_SH_SSH_KEY=~/.ssh/id_ed25519

Then use the full claude mcp add command from the Single instance (XML-RPC + SSH) section above.

Development

git clone https://github.com/nicoruiz/odoo-sh-mcp
cd odoo-sh-mcp
python3 -m venv .venv && source .venv/bin/activate
pip install -e "." pytest pytest-asyncio
pytest tests/ -v

License

MPL-2.0