MCP server bridging Claude.ai/Desktop with self-hosted OpenClaw via OAuth 2.1.
MCP server bridging Claude.ai/Desktop with self-hosted OpenClaw via OAuth 2.1. Exposed over MCP by the openclaw mcp server, that capability becomes something an assistant can invoke while it works, not something you go and do afterwards.
🦞 Model Context Protocol (MCP) server for OpenClaw AI assistant integration.
Everything the assistant can do here goes through one of these:
openclaw_chat — Send messages to OpenClaw and get responsesopenclaw_status — Check OpenClaw gateway healthopenclaw_instances — List all configured OpenClaw instancesopenclaw_chat_async — Queue a message, get task_id immediatelyopenclaw_task_status — Check task progress and get resultsopenclaw_task_list — List your tasks with filteringopenclaw_task_cancel — Cancel a pending taskSetup — The Setup tool exposed by this serverUsage — All tools accept an optional instance parameter to target a specific gateway:You will need 7 environment variables: OPENCLAW_URL, OPENCLAW_GATEWAY_TOKEN, OPENCLAW_MODEL, OPENCLAW_TIMEOUT_MS, MCP_CLIENT_SECRET, MCP_CLIENT_ID, MCP_ISSUER_URL. The server will not start without them, which is usually why the tools fail to appear on a first run. Keep credentials in your client's env block or a secrets manager rather than in a file you might commit.
Being a remote server, there is no local install. You register the endpoint with your client, authorise it once, and the tools appear.
Among the planning and project tracking options, the useful question is rarely "what can it do" but "what does it cost you to run" — permissions, credentials, and how much of your context its toolset consumes. Openclaw's toolset — openclaw_chat, openclaw_status, openclaw_instances and 6 more — is a fair guide to whether it matches your workflow. It is maintained by freema; worth a glance at recent repository activity before you build anything load-bearing on it.
This entry was verified against Openclaw's own documentation before publication; SyncDev keeps the directory reviewed rather than auto-generated.
| Tool | What it does |
|---|---|
| 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 |
| Setup | The Setup tool exposed by this server. |
| Usage | All tools accept an optional instance parameter to target a specific gateway: |
Add to your Claude Desktop config:
```json
{
"mcpServers": {
"openclaw": {
"command": "npx",
"args": ["openclaw-mcp"],
"env": {
"OPENCLAW_URL": "http://127.0.0.1:18789",
"OPENCLAW_GATEWAY_TOKEN": "your-gateway-token",
"OPENCLAW_MODEL": "openclaw",
"OPENCLAW_TIMEOUT_MS": "300000"
}
}
}
}Configuration as documented by the project. Restart the client after saving.
| Variable | Description | Required |
|---|---|---|
| OPENCLAW_URL | Endpoint or connection string the server talks to. | Yes |
| OPENCLAW_GATEWAY_TOKEN | Credential the server authenticates with. | Yes |
| OPENCLAW_MODEL | Configuration value read at startup. | Optional |
| OPENCLAW_TIMEOUT_MS | Configuration value read at startup. | Optional |
| MCP_CLIENT_SECRET | Credential the server authenticates with. | Yes |
| MCP_CLIENT_ID | Configuration value read at startup. | Optional |
| MCP_ISSUER_URL | Endpoint or connection string the server talks to. | Yes |
Your workspace, on speaking terms with AI — search, read and write Notion pages and databases.
Issue tracking at the speed of conversation — Linear's official hosted server with OAuth and zero install.
Search and read your Drive — Docs, Sheets and files become context your assistant can actually use.
Your assistant inside the workspace — read channels, search history, post messages and tame the noise.
Metabase ships its own MCP endpoint — search your BI content, build and run queries, and save questions and dashboards without leaving the chat.
Stop letting your assistant hallucinate n8n node parameters — this server hands it the real schemas, templates and validation.