Connecting

MCP configuration

HUSK exposes a standard MCP endpoint at /mcp. Any MCP-compatible client can connect using HTTP transport with a Bearer token.

Per-project

Create .mcp.json in your project root:

{
  "mcpServers": {
    "husk": {
      "type": "http",
      "url": "http://localhost:3000/mcp",
      "headers": {
        "Authorization": "Bearer husk_your-api-key-here"
      }
    }
  }
}

Global (all projects)

Place the same file at ~/.claude/.mcp.json so every Claude Code session has access.

Plugins

For session tracking, auto-start, and editor-specific skills, install a plugin on top of MCP:

• Claude Code plugin — hooks + skills for Claude Code
• OpenCode plugin — hooks with file-edit tracking for OpenCode

See the Plugins overview for a feature comparison.

Verifying the connection

After connecting, ask Claude Code to run a quick test:

Search my HUSK memories for "test"

If everything is wired up, you'll see results (or an empty list if this is a fresh install). If you see an error about the MCP server being unavailable, check that HUSK is running and the API key is correct.