How to install Honcho in Windsurf

Memory that reasons: continual learning for stateful agents. Better context, fewer tokens.

Indexed, not yet reviewed

We found Honcho in the official MCP registry. Our automated check passed on Nov 1, 2026 (it confirms the server is published and reachable), but no one at CuratedMCP has reviewed its code, permissions or credentials handling. Check what it can access before you give it keys. Scan your machine free to see every MCP server you have installed.

Steps

1Open ~/.codeium/windsurf/mcp_config.json
2Add the entry below. If the file already has "mcpServers", add just the inner entry
3Refresh the MCP servers list in Windsurf's Cascade panel

Configuration

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "honcho": {
      "serverUrl": "https://mcp.honcho.dev",
      "headers": {
        "Authorization": "<your-authorization>"
      }
    }
  }
}

Replace the values in angle brackets. Optional settings are listed below.

Header	Required	What it is
Authorizationsecret	Yes	Authorization header for Honcho. Use either an OAuth access token or a Honcho API key from https://app.honcho.dev (API keys start with hch-). Send as: Bearer <token>.
X-Honcho-Workspace-ID	No	Optional. Target Honcho workspace; defaults to 'default' when omitted.

Install in other clients

Claude Code Cursor Claude Desktop Gemini CLI OpenAI Agents SDK

About Honcho: repo, license and check results →

Maintain Honcho?

Claim this page to get a full CuratedMCP listing: edit your description, see listing analytics, and add our README badge. Listing is free, and a person checks every submission before it goes live. We'll pre-fill the form from the registry.

Claim this listing What maintainers get