Back to home
Integration

Windsurf + agimem

Give your Windsurf Cascade agent persistent memory that survives across sessions.

Windsurf's Cascade agent is great at understanding your codebase in real time. With agimem, it can also remember things between sessions — architecture decisions, debugging notes, preferred libraries, and project-specific context. Connect agimem as an MCP server and Cascade picks up where it left off instead of starting fresh.

Windsurf Cascade
Windsurf Chat
Any Windsurf MCP-enabled mode

Setup in 4 steps

1

Create a Capsule on agimem

Sign up at agimem.dev and create a Capsule from the dashboard. Each Capsule is an isolated memory space for your agent.

2

Generate an API key

Click your Capsule and generate an API key. It starts with mcp_ — copy it immediately as it won't be shown again.

3

Add the MCP server to Windsurf

Open Windsurf Settings → MCP, or edit ~/.codeium/windsurf/mcp_config.json directly. Add the agimem server configuration with your API key.

4

Start using memory

Cascade now has access to memory tools. Ask it to store your project's conventions or architecture notes, and they'll persist across every future session.

Fastest way: paste a prompt

Give this prompt to your Windsurf agent and it will configure everything automatically:

Agent prompt

Read the instructions at https://agimem.dev/setup and follow them to configure the memory MCP server for this project.

Manual configuration

Add this to your Windsurf MCP configuration file. Windsurf stores MCP config globally:

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "agimem": {
      "url": "https://agimem.dev/api/mcp",
      "headers": {
        "Authorization": "Bearer mcp_your_api_key"
      }
    }
  }
}

What your agent can do with agimem

Store and recall coding conventions
Remember project architecture across sessions
Share context between multiple agents
Keep research notes and findings persistent
Track preferences and writing style
Maintain state for long-running automations
Organize memories with tags
Set time-to-live for temporary data

Frequently asked questions

Does Windsurf support remote MCP servers?

Yes. Windsurf supports remote MCP servers via Streamable HTTP transport, which is what agimem uses. No local process or stdio setup needed.

Can I use different Capsules for different projects?

Yes. You can create multiple Capsules on agimem and switch the API key in your config depending on the project. Or use one Capsule for everything — it's up to you.

How does this compare to Windsurf's built-in memories?

Windsurf has its own memory features, but agimem gives you a portable memory layer that works across any MCP client. Your agent's memories aren't locked into one tool.

Ready to get started?

Create a free Capsule and connect Windsurf in under a minute.