
OpenClaw MCP Server
Delegate tasks from Claude.ai to your self-hosted OpenClaw agent with OAuth 2.1
- 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-mcpAdd 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 gatewayRequiredOPENCLAW_GATEWAY_TOKENBearer token for OpenClaw gateway authenticationRequiredOPENCLAW_MODELModel name for chat completions (e.g. 'openclaw' or 'openclaw/<agentId>')OPENCLAW_TIMEOUT_MSRequest timeout in millisecondsOPENCLAW_URLURL of your OpenClaw gatewayRequiredOPENCLAW_GATEWAY_TOKENBearer token for OpenClaw gateway authenticationRequiredOPENCLAW_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

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools