Skip to content
MCP server

OpenClaw MCP Server

Delegate tasks from Claude.ai to your self-hosted OpenClaw agent with OAuth 2.1

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
self-hosted, CLI
Runs
Locally
Version
1.8.1
Listing updated
2 days ago

About OpenClaw MCP Server

OpenClaw MCP Server is an open-source MCP server for ai models and llm tooling. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

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

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

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

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

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

Configuration

  • OPENCLAW_URLURL of your OpenClaw gatewayRequired
  • OPENCLAW_GATEWAY_TOKENBearer token for OpenClaw gateway authenticationRequired
  • OPENCLAW_MODELModel name for chat completions (e.g. 'openclaw' or 'openclaw/<agentId>')
  • OPENCLAW_TIMEOUT_MSRequest timeout in milliseconds
  • OPENCLAW_URLURL of your OpenClaw gatewayRequired
  • OPENCLAW_GATEWAY_TOKENBearer token for OpenClaw gateway authenticationRequired
  • OPENCLAW_MODELModel name for chat completions

Tools this server provides (6)

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

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.

What it does

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

Pricing

Open source

MIT-licensed; self-hosted

Prices change. Check openclaw-mcp.cloud before you buy.

OpenClaw MCP Server 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 to OpenClaw MCP Server

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools