# OpenClaw MCP Server (MCP server)

> OpenClaw MCP Server is an MCP server that adds cloud and DevOps tools to AI assistants such as Claude Desktop, Claude Code and Cursor. MCP server bridging Claude.ai/Desktop with self-hosted OpenClaw via OAuth 2.1. It has 185 GitHub stars, is released under the MIT license and runs locally with npx -y openclaw-mcp.

🦞 Model Context Protocol (MCP) server for OpenClaw AI assistant integration. Hey! I created this MCP server because I didn't want to rely solely on messaging channels to communicate with OpenClaw. What really excites me is the ability to connect OpenClaw to the Claude web UI. Essentially, my chat can delegate tasks to my Claw bot, which then handles everything else — like spinning up Claude Code to fix issues for me.

## Key facts

| Fact | Value |
|---|---|
| Repository | https://github.com/freema/openclaw-mcp |
| GitHub stars | 185 |
| License | MIT |
| Language | TypeScript |
| Transport | stdio |
| Packages | npm: openclaw-mcp; docker: ghcr.io/freema/openclaw-mcp:1.7.0 |
| Remote URL | none |
| Needs API key | yes |
| Official | no |
| Works with | Claude Desktop, Claude Code, Cursor, VS Code |
| Category | Cloud & DevOps |
| Latest release | 1.7.0 (Jul 26, 2026) |
| Last commit | Sep 19, 2026 |
| MCP registry name | io.github.freema/openclaw-mcp |

## Install

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "openclaw-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "openclaw-mcp"
      ],
      "env": {
        "OPENCLAW_URL": "your-value",
        "OPENCLAW_GATEWAY_TOKEN": "your-value"
      }
    }
  }
}
```

Settings > Developer > Edit Config. macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\. Restart Claude Desktop afterwards.

### Claude Code

```sh
claude mcp add --env OPENCLAW_URL=your-value --env OPENCLAW_GATEWAY_TOKEN=your-value --transport stdio openclaw-mcp-server -- npx -y openclaw-mcp
```

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

```json
{
  "mcpServers": {
    "openclaw-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "openclaw-mcp"
      ],
      "env": {
        "OPENCLAW_URL": "your-value",
        "OPENCLAW_GATEWAY_TOKEN": "your-value"
      }
    }
  }
}
```

Project file; use ~/.cursor/mcp.json to enable it in every project.

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

```json
{
  "inputs": [
    {
      "type": "promptString",
      "id": "openclaw_gateway_token",
      "description": "OPENCLAW_GATEWAY_TOKEN",
      "password": true
    }
  ],
  "servers": {
    "openclaw-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "openclaw-mcp"
      ],
      "env": {
        "OPENCLAW_URL": "your-value",
        "OPENCLAW_GATEWAY_TOKEN": "${input:openclaw_gateway_token}"
      }
    }
  }
}
```

Config formats checked against the official docs on 2026-10-07.

## Environment variables

- `OPENCLAW_URL` (required): URL of your OpenClaw gateway
- `OPENCLAW_GATEWAY_TOKEN` (secret) (required): Bearer token for OpenClaw gateway authentication
- `OPENCLAW_MODEL`: Model name for chat completions (e.g. 'openclaw' or 'openclaw/')
- `OPENCLAW_TIMEOUT_MS`: Request timeout in milliseconds

## Tools

- `openclaw_chat`: Send messages to OpenClaw and get responses
- `openclaw_status`: Check OpenClaw gateway health
- `openclaw_instances`: List all configured OpenClaw instances
- `openclaw_chat_async`: Queue a message, get task_id immediately
- `openclaw_task_status`: Check task progress and get results
- `openclaw_task_list`: List your tasks with filtering
- `openclaw_task_cancel`: Cancel a pending task

## Similar MCP servers

- [Worldmonitor](https://appsgit.com/mcp-servers/worldmonitor): Real-time global intelligence dashboard. AI-powered news aggregation, geopolitical monitoring, and infrastructure tracking in a unified situational awareness interface. (87,920 stars, AGPL-3.0)
- [Netdata](https://appsgit.com/mcp-servers/netdata): Real-time infrastructure monitoring with metrics, logs, alerts, and ML-based anomaly detection. (80,817 stars, GPL-3.0, needs API key)
- [openstatus](https://appsgit.com/mcp-servers/openstatus): Manage monitors, status pages, incidents and maintenances in your openstatus workspace. (9,171 stars, AGPL-3.0, official)
- [MCP Server Cloudflare](https://appsgit.com/mcp-servers/mcp-server-cloudflare): Model Context Protocol (MCP) is a new, standardized protocol for managing context between large language models (LLMs) and external systems. (4,360 stars, Apache-2.0, official, needs API key)
- [Dagu](https://appsgit.com/mcp-servers/dagu): Self-hostable workflow orchestrator for teams whose main work isn't orchestration. (4,289 stars, GPL-3.0)
- [Azure MCP Server](https://appsgit.com/mcp-servers/azure-mcp-server): All Azure MCP tools to create a seamless connection between AI agents and Azure services. (3,738 stars, MIT, official)

---

Canonical page: https://appsgit.com/mcp-servers/openclaw-mcp-server
Source: appsgit (https://appsgit.com), the app store for github. Data from the GitHub API, refreshed nightly.
Machine access: JSON API https://appsgit.com/api/v1/apps (OpenAPI: https://appsgit.com/openapi.json), MCP server https://mcp.appsgit.com/mcp, full index https://appsgit.com/llms-full.txt.