Skip to main content
Claude Desktop supports MCP servers configured in a local JSON file. You can add Memory Crystal to Claude Desktop in a few minutes.

​
Prerequisites

Install the @memorycrystal/mcp-server npm package: 
npm install -g @memorycrystal/mcp-server
You’ll also need your Memory Crystal API key and backend URL. Find these in your Memory Crystal dashboard.

​
Configure

1

Open the Claude Desktop config file

Edit ~/.claude/claude_desktop_config.json. Create the file if it doesn’t exist.
2

Add the Memory Crystal MCP server

Add a memory-crystal entry under mcpServers:
{
  "mcpServers": {
    "memory-crystal": {
      "command": "crystal-mcp",
      "env": {
        "MEMORY_CRYSTAL_API_KEY": "your-api-key-here",
        "MEMORY_CRYSTAL_API_URL": "https://your-deployment.convex.site"
      }
    }
  }
}
Replace your-api-key-here with your API key and your-deployment.convex.site with your Memory Crystal backend URL.
3

Restart Claude Desktop

Quit and reopen Claude Desktop to load the new configuration.

​
Verify

After restarting Claude Desktop, confirm Memory Crystal is connected:
  1. Open a new conversation in Claude Desktop.
  2. Ask Claude to run crystal_stats. It should return your memory usage statistics.
  3. Ask Claude to run crystal_wake. It should return a session briefing with any active context from previous sessions.
If the tools don’t appear, check that:
  • crystal-mcp is on your PATH (run which crystal-mcp in a terminal)
  • The MEMORY_CRYSTAL_API_KEY and MEMORY_CRYSTAL_API_URL values in the config are correct
  • The config file is valid JSON (no trailing commas or missing quotes)
Start each Claude Desktop session with crystal_wake to load your current context — active goals, recent decisions, and anything saved from previous sessions.