Windsurf (Devin Desktop)

For AI Agents

Machine-readable docs: mnemoverse/llms.txt (works in all sandboxes)

Give Windsurf persistent memory. Windsurf is now Devin Desktop (docs) — the config path below still works there.

You'll need an API key — get one free at console.mnemoverse.com (no credit card). If you already have a key from Claude Code, Cursor, or ChatGPT — use the same one. That's the point.

Add to Windsurf

Windsurf — add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "mnemoverse": {
      "command": "npx",
      "args": [
        "-y",
        "@mnemoverse/mcp-memory-server@latest"
      ],
      "env": {
        "MNEMOVERSE_API_KEY": "mk_live_YOUR_KEY",
        "MNEMOVERSE_API_URL": "https://core.mnemoverse.com/api/v1"
      }
    }
  }
}

⚠️ Restart the editor after editing the config file. MCP servers are only picked up on client startup.

Why @latest? It forces a registry metadata lookup on every session start so you always get the newest release — bare npx @mnemoverse/mcp-memory-server caches the first installed version indefinitely.

The keyless Mnemoverse Memory extension is also on Open VSX and works in Windsurf — install, click Sign In, done.

Prefer no key? You can point Windsurf at the hosted connector — see Remote MCP Server; whether sign-in completes depends on the registration allowlist. If it doesn't, the config above always works.

Try It

Make the assistant actually use Mnemoverse

Connecting adds the memory tools; it doesn't make the assistant use them. By default it answers from its own context, not Mnemoverse. Set a one-line standing instruction first: Make Your Agent Use Memory.

With that in place, the win is one memory across tools. In Windsurf:

"Remember: this repo's migrations run with make db-migrate, never prisma migrate directly."

Later, in Claude Code or ChatGPT — a different tool:

"How do I run migrations here?"

It recalls the rule, because the memory lives in Mnemoverse, not in the editor. (A same-tool "it remembers" demo wouldn't prove much — cross-tool recall is what needs Mnemoverse.)

Tools

The MCP server gives Windsurf 7 core memory tools:

Tool	What it does
memory_write	Store a preference, decision, or lesson
memory_read	Search memories by natural language query — optionally newest-first (order_by) or time-bounded (since / until)
memory_list_recent	List newest memories first, no query — catch up after a break or on a shared room
memory_feedback	Report if a memory was helpful (+1) or wrong (-1)
memory_stats	Check how many memories are stored
memory_delete	Permanently delete a single memory by its id
memory_delete_domain	Wipe all memories in a domain (requires explicit confirm)

For detailed parameter docs, see Claude Code or API Reference. Shared rooms (Beta) are covered in Join a shared room.

Universal Memory

Same API key, same memories — across all tools.

                    ┌── Claude Code / Desktop
   Mnemoverse API ──├── Windsurf ← you are here
   (one memory)     ├── Cursor / VS Code
                    ├── ChatGPT (Custom Actions)
                    └── Python SDK / REST

Write a memory in Windsurf → Claude Code reads it. Learn something in Cursor → ChatGPT knows it.

Configuration

Variable	Required	Default
MNEMOVERSE_API_KEY	Yes	—
MNEMOVERSE_API_URL	No	https://core.mnemoverse.com/api/v1

MNEMOVERSE_API_URL is the REST backend the local server talks to — it is not an MCP endpoint; never paste it into the "add MCP server by URL" field. A remote MCP connector uses https://mcp.mnemoverse.com/mcp (Remote MCP Server).

Common questions

How do I add persistent memory to Windsurf?

Add the Mnemoverse MCP server to ~/.codeium/windsurf/mcp_config.json with your API key and restart the editor. The path still works after the Windsurf-to-Devin-Desktop rename. One free key from console.mnemoverse.com covers every tool.

Does the Windsurf config still work in Devin Desktop?

Yes. Windsurf is now Devin Desktop, and the ~/.codeium/windsurf/mcp_config.json path still works there — the same MCP server entry applies.

Can Windsurf share memory with Claude Code, Cursor, and ChatGPT?

Yes. All tools connect to the same hosted memory behind one API key or OAuth, so a fact stored from Windsurf is recalled in Claude Code, Cursor, or ChatGPT without re-explaining.

Source & Distribution

The MCP server is listed on the Official MCP Registry. Source code is open on GitHub under MIT.

Related

• Make Your Agent Use Memory — connecting is step one; get the agent to actually call the memory tools
• Cursor — one-click install or .cursor/mcp.json
• VS Code — keyless extension with browser sign-in
• Editors overview — all editor paths side by side
• Claude Code — the Claude CLI
• ChatGPT — give any Custom GPT persistent memory
• Remote MCP Server — connect over one-click OAuth, no API key
• API Reference — full endpoint documentation