Persistent Memory for Windsurf - Unison MCP Setup

Learn how to give Windsurf persistent team memory using the Unison MCP server.

Install

Add to Windsurf's MCP configuration:

{
  "mcpServers": {
    "unison-brain": {
      "command": "npx",
      "args": ["-y", "@unisonlabs/mcp"],
      "env": { "UNISON_TOKEN": "usk_live_..." }
    }
  }
}

The loop the agent runs

1. Task start: brain_context with the task as the query - relevant decisions, facts, and history arrive as one markdown block.
2. While working: brain_record_fact when something durable is learned; brain_write for documents worth keeping.
3. Task end: brain_ingest the conversation so extraction captures what the session produced.

Every other session - yours, your teammates', tomorrow's - recalls what this one learned.