Skip to main content
For AI agents: a documentation index is at /llms.txt. Every page is also available as markdown, just append .md to the URL.

Overview

OpenClaw manages MCP servers through its openclaw mcp commands and stores them in ~/.openclaw/openclaw.json. You add Reap as a streamable HTTP server with OAuth, sign in, and pick the workspace OpenClaw is allowed to use.

Before You Start

  • Your Reap workspace must be on a paid plan with API access enabled.
  • Install OpenClaw and have your gateway running.
  • You need access to the Reap workspace you want to connect.

Reap MCP Server URL

Add Reap To OpenClaw

1

Add the server

2

Sign in to Reap

OpenClaw opens the Reap authorization page. If your setup returns an authorization code instead of completing in the browser, pass it back:
3

Choose a workspace and authorize

Sign in to Reap, select the workspace OpenClaw is allowed to use, and click Authorize.
4

Reload the server

This clears the cached MCP runtime for the current CLI process. Gateway processes need their own restart or reload before they pick up the new server.

Edit The Config Directly

If you prefer to edit the file, the entry lives under mcp.servers in ~/.openclaw/openclaw.json:
The canonical field is transport: "streamable-http". OpenClaw also accepts the CLI-native type: "http" alias when saved through openclaw mcp set, and openclaw doctor --fix normalizes it.

Confirm The Connection Works

The second command lists the Reap tools available to your agent. You can also ask in chat:

Troubleshooting

  • Server unhealthy? Run openclaw mcp doctor or openclaw mcp probe reap to see the connection error.
  • Tools missing after login? Run openclaw mcp reload, then restart the gateway process.
  • Login loop? Run openclaw mcp logout reap followed by openclaw mcp login reap to start a clean OAuth flow.
  • Wrong workspace? Log out, log in again, and pick the correct workspace on the Reap authorization screen.
Do not paste secrets inline in openclaw.json, because the file ends up in backups and migrations. Reap MCP uses OAuth, so there is no API key to store here.

Learn More