Skip to content
MCP server

oec.sh

Manage Odoo servers, environments, logs, deploys and backups on oec.sh from your AI client

Pricing
Paid
Platforms
API, CLI, Web
Runs
Locally or Remotely
Version
0.4.1
Listing updated
3 days ago

About oec.sh

oec.sh is a paid MCP server for cloud and infrastructure. It can run locally on your machine or as a hosted remote server.

Everything this server does is a call to the oec.sh public API made with your own API key, so the key decides what the assistant can touch. A read-only key (oec_live_ro_) offers look-but-don't-touch tools, a full-access key (oec_live_rw_) adds deploy and restart, and a project-scoped key hides every other project. Destructive actions and backup downloads stay off unless you opt in with the OECSH_ALLOW setting.

On the read side there are tools for servers and their live CPU, memory and disk, projects, environments with health and last deployment, the newest 1,000 lines of an environment's Odoo or PostgreSQL log, deployment history, backups, webhooks and their deliveries, support tickets and the oec.sh changelog. For long jobs there are task tools that check status, wait for completion and fetch a step log.

It runs locally over stdio (Node.js 22 or newer) or as a hosted endpoint at mcp.oec.sh where your client sends the key in an Authorization header. The hosted server stores nothing and does not support OAuth-only clients such as claude.ai web connectors yet.

Install

Run in a terminal

claude mcp add --transport http mcp-server https://mcp.oec.sh/mcp

Add to Settings → Connectors → Add custom connector

https://mcp.oec.sh/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp-server": {
      "url": "https://mcp.oec.sh/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "mcp-server": {
      "type": "http",
      "url": "https://mcp.oec.sh/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp-server": {
      "serverUrl": "https://mcp.oec.sh/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "mcp-server": {
      "type": "http",
      "url": "https://mcp.oec.sh/mcp"
    }
  }
}

Configuration

  • OECSH_API_KEYYour oec.sh API key (oec_live_ro_... read only, or oec_live_rw_... full access), from Settings > API Keys.Required
  • OECSH_ALLOWOpt-in tools, comma separated: destructive, backup-download. Empty by default.

Tools this server provides (12)

Taken from the project documentation; the running server may differ.

oecsh_get_organization
Your plan, limits and current usage
oecsh_list_servers
Lists servers
oecsh_get_server_metrics
Live CPU, memory, disk and network of one of your own servers
oecsh_list_environments
A project's environments, optionally filtered by status
oecsh_get_runtime_logs
The newest lines of an environment's Odoo or PostgreSQL log
oecsh_get_environment_metrics
Live CPU and memory of an environment's containers and its disk sizes
oecsh_list_deployments
An environment's deployment history
oecsh_wait_for_task
Waits until a task finishes
oecsh_get_task_log
A task's step log and error message
oecsh_list_backups
An environment's backups
oecsh_list_changelog
oec.sh release notes, newest first
oecsh_deploy_environment
Pulls the latest code and redeploys, optionally updating modules

What it does

Scoped API keys
Read-only, full-access and single-project keys limit what the assistant can do.
Live logs and metrics
Reads Odoo or PostgreSQL logs and live CPU and memory for an environment.
Deploy and restart
With a full-access key, redeploys environments and updates modules.
Task tracking
Checks a task's status, waits for it to finish and reads its step log.
Backups and webhooks
Lists backups, webhooks and recent webhook deliveries.
Local or hosted
Runs through npx over stdio or at a hosted URL.

Good for

  • Ask why an Odoo environment is unhealthy and read its recent log
  • Redeploy and follow the deployment to completion
  • Check server load before scheduling a deploy
  • Review backups and recent deployments for a project

Pricing

Paid

Needs an oec.sh Starter plan or higher; prices not published here

Prices change. Check doc.oec.sh before you buy.

oec.sh FAQ

What do I need to use it?

An oec.sh organization on the Starter plan or higher and an API key from Settings > API Keys.

Can it delete data?

The full-access tools listed do not delete data, and destructive actions and backup downloads are opt-in.

Does the hosted server keep my key?

No. It forwards the key to the API for that request only.

Which clients work?

Claude Code, Claude Desktop, Cursor and others that let you set a header; OAuth-only connectors are not supported yet.

Is oec.sh free?

No. oec.sh is a paid product.

How do I add oec.sh to Claude Code?

Run this command in your terminal: claude mcp add --transport http mcp-server https://mcp.oec.sh/mcp

What are the best alternatives to oec.sh?

The closest alternatives to oec.sh are Agent Yurt, Proofline, filex, MagicWP MCP and Kubana Cloud Domains.

Alternatives to oec.sh

  1. Agent Yurt

    MCP server

    Back up agent memory, files and dashboards, then recover from a reviewed snapshot

    Not checked yet
    • Remote
    • Free
    • Knowledge and memory
  2. Proofline

    MCP server

    Production-aware review of changes against your AWS or Google Cloud setup, via MCP

    • Remote
    • Freemium
    • Developer tools
  3. filex

    MCP server

    Self-hosted file manager in one Go binary with a built-in MCP server for agents

    Not checked yet
    • Remote
    • Open source
    • Files and documents
  4. MagicWP MCP

    MCP server

    Run WordPress hosting from an assistant: backups, staging, updates, PHP and domains

    • Remote
    • Free trial
    • Cloud and infrastructure
  5. Search, register and renew domains and set nameservers at Kubana Cloud from an assistant

    Not checked yet
    • 3 tools
    • Remote
    • Paid
    • Cloud and infrastructure
  6. Create DNS zones, edit records and check nameserver delegation on Kubana Cloud

    Not checked yet
    • 5 tools
    • Remote
    • Free
    • Cloud and infrastructure