Give Windsurf a memory that survives the session

Every new Cascade session starts from zero: your conventions, your architecture decisions, the bug you fixed on Friday — gone. Engram gives Windsurf permanent, searchable memory across sessions, projects, and machines. Setup is one config block.

No API key. Windsurf signs in to Engram over OAuth — approve it once and the connection persists.

1. Add one config block

In Windsurf, open Settings → Windsurf Settings → Cascade → MCP Servers, choose Add Server View raw config, and add the engram entry to mcp_config.json:

{
  "mcpServers": {
    "engram": {
      "serverUrl": "https://mcp.getengram.app/mcp"
    }
  }
}

Press the refresh button after saving. Windsurf opens an Engram sign-in in your browser — approve it once and you are connected; a free account is created if you do not have one.

2. Never re-explain your project again

After a useful session: “remember this.” Next week, next project, next machine: “what do you remember about the auth refactor?” Cascade searches your entire history semantically and picks up where you left off — decisions, reasoning, and all.

Team setup or CI?

Pin an API key from your dashboard instead of OAuth (key in an env var) so everyone shares the same project memory:

{
  "mcpServers": {
    "engram": {
      "serverUrl": "https://mcp.getengram.app/mcp",
      "headers": {
        "Authorization": "Bearer engram_sk_live_your_key_here"
      }
    }
  }
}

The same memory follows you everywhere

Engram speaks MCP, so the memory Windsurf builds is instantly available in Cursor, Claude Code, Claude Desktop, ChatGPT — any client you connect. Debug in Windsurf, ask ChatGPT about it later, plan in Claude with full context. One memory, every tool.

Every word is kept — never summarized — and nothing ever expires. Free plan stores 10,000 messages. Pro is $9/month for 1,000,000.