# oec.sh

> oec.sh is a paid MCP server for cloud and infrastructure. Manage Odoo servers, environments, logs, deploys and backups on oec.sh from your AI client. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Paid
- **Platforms:** API, CLI, Web
- **Website:** https://doc.oec.sh/api-reference/mcp-server/
- **Repository:** https://github.com/oecsh/mcp-server
- **MCP Registry name:** sh.oec/mcp-server
- **Categories:** cloud and infrastructure
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.oec.sh/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp-server": {
      "url": "https://mcp.oec.sh/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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

## 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

- [Agent Yurt](https://ai-powered.com/mcp/agent-yurt): Agent Yurt is a free MCP server for knowledge and memory.
- [Proofline](https://ai-powered.com/mcp/proofline): Proofline is a freemium MCP server for developer tools.
- [filex](https://ai-powered.com/mcp/filex): filex is an open-source MCP server for files and documents.
- [MagicWP MCP](https://ai-powered.com/mcp/magicwp-mcp): MagicWP MCP is an MCP server for cloud and infrastructure.
- [Kubana Cloud Domains](https://ai-powered.com/mcp/kubana-cloud-domains): Kubana Cloud Domains is a paid MCP server for cloud and infrastructure.
- [Kubana Cloud DNS Management](https://ai-powered.com/mcp/kubana-cloud-dns-management): Kubana Cloud DNS Management is a free MCP server for cloud and infrastructure.
- [Kubana Cloud VPS](https://ai-powered.com/mcp/kubana-cloud-vps): Kubana Cloud VPS is a paid MCP server for cloud and infrastructure.
- [AgentViva](https://ai-powered.com/mcp/agentviva): AgentViva is a free MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/oec-sh
