# OpenClaw MCP Server

> OpenClaw MCP Server is an open-source MCP server for ai models and llm tooling. Delegate tasks from Claude.ai to your self-hosted OpenClaw agent with OAuth 2.1. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** self-hosted, CLI
- **Website:** https://openclaw-mcp.cloud
- **Repository:** https://github.com/freema/openclaw-mcp
- **MCP Registry name:** io.github.freema/openclaw-mcp
- **Categories:** AI models and LLM tooling, developer tools
- **Listing updated:** 2026-11-15

## About

The author built this bridge because he wanted to reach OpenClaw from the Claude web interface and not only through messaging channels. A chat in Claude can hand a task to an OpenClaw agent running on your own infrastructure, which then does the work, for example starting Claude Code to fix an issue.

The server talks to your OpenClaw gateway using a URL and bearer token. Long jobs run through an async queue: you start a chat task, then poll its status, list running tasks or cancel one. Several gateways, such as prod, staging and dev, can be routed from one server by name. Inputs are checked with Zod schemas.

It runs over stdio for Claude Desktop or over HTTP or SSE for Claude.ai, where an OAuth 2.1 handshake protects the connection. Docker images are published to GHCR, and the README recommends pointing it at a least-privilege agent instead of your main one with shell access. A Claude Code plugin adds /claw:chat and /claw:status commands.

## Features

- **Claude to OpenClaw bridge:** Lets a Claude chat delegate work to a self-hosted agent.
- **Async task queue:** Start long jobs and check, list or cancel them later.
- **OAuth 2.1 for remote use:** Secures connection from Claude.ai.
- **Multi-instance routing:** Reach prod, staging and dev gateways by name.
- **Docker image:** Prebuilt GHCR image with a hardened compose example.
- **Claude Code plugin:** Adds skills, commands and a task-delegator agent.

## Good for

- Ask Claude.ai to run a task on your private agent
- Start a long job and check progress later
- Route a request to a staging OpenClaw gateway
- Check that your OpenClaw gateway is healthy
- Run the bridge in Docker behind a reverse proxy

## Install

### Claude Code (Terminal)

```sh
claude mcp add openclaw-mcp --env OPENCLAW_URL='<OPENCLAW_URL>' --env OPENCLAW_GATEWAY_TOKEN='<OPENCLAW_GATEWAY_TOKEN>' -- npx -y openclaw-mcp
```

### Claude Desktop (claude_desktop_config.json)

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

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

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

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

```json
{
  "servers": {
    "openclaw-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "openclaw-mcp"
      ],
      "env": {
        "OPENCLAW_URL": "<OPENCLAW_URL>",
        "OPENCLAW_GATEWAY_TOKEN": "<OPENCLAW_GATEWAY_TOKEN>"
      }
    }
  }
}
```

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

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

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

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

## Tools

- `openclaw_chat`: Simple text inference through the OpenClaw gateway.
- `openclaw_status`: Agent health check.
- `openclaw_chat_async`: Queued chat execution.
- `openclaw_task_status`: Check the progress of a specific task.
- `openclaw_task_list`: List all running tasks.
- `openclaw_task_cancel`: Cancel a pending task.

## FAQ

### What does the connector URL need to end with?

/mcp. A bare domain returns 404 after OAuth completes.

### Which transports are supported?

stdio for Claude Desktop and HTTP or SSE for remote hosting.

### How should I limit risk?

Set OPENCLAW_AGENT_ID to a dedicated agent with only the tools you want Claude to reach.

### Is it open source?

The README shows an MIT licence badge.

### Is OpenClaw MCP Server free?

Yes. OpenClaw MCP Server is open source, so you can use and self-host it for free.

### How do I add OpenClaw MCP Server to Claude Code?

Run this command in your terminal: claude mcp add openclaw-mcp --env OPENCLAW_URL='<OPENCLAW_URL>' --env OPENCLAW_GATEWAY_TOKEN='<OPENCLAW_GATEWAY_TOKEN>' -- npx -y openclaw-mcp

### What are the best alternatives to OpenClaw MCP Server?

The closest alternatives to OpenClaw MCP Server are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/openclaw-mcp-server
