Setup Guides

Connect Memstate to your AI agent in 30 seconds. Pick your agent below for a step-by-step guide with exact config paths and copy-paste snippets.

One-liner setup (auto-detects your agents)

npx @memstate/mcp setup

Detects installed agents, writes the MCP config automatically, and opens your browser to create an API key. Or follow a manual guide below.

Claude Desktop & Claude Code

Add persistent, versioned memory to Anthropic's Claude. Works with Claude Desktop and Claude Code.

~/Library/Application Support/Claude/claude_desktop_config.json

Cursor

Give Cursor a structured memory layer that persists across sessions and projects.

.cursor/mcp.json (project) or ~/.cursor/mcp.json (global)

Cline (VS Code)

Extend Cline with long-term memory so it remembers your architecture decisions and project context.

VS Code Settings → Cline MCP Settings

Windsurf

Connect Windsurf to Memstate for structured memory that survives session resets.

~/.codeium/windsurf/mcp_config.json

Gemini CLI

Add structured memory to Google's Gemini CLI agent for persistent project context.

~/.gemini/settings.json

Kilo Code

Set up Memstate MCP with Kilo Code for versioned, structured agent memory.

VS Code Settings → Kilo Code MCP Settings

GitHub Copilot

Extend GitHub Copilot with persistent memory via the MCP protocol.

.github/copilot-instructions.md + MCP config

Universal MCP Config

Any MCP-compatible agent uses this same JSON snippet. Just add it to your agent's config file.

{
  "mcpServers": {
    "memstate": {
      "command": "npx",
      "args": ["-y", "@memstate/mcp"],
      "env": {
        "MEMSTATE_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

Get your API key from the dashboard. No local installation required — npx handles it automatically.