ChatCrystal MCP Server

by zengliangyiio.github.ZengLiangYi/chatcrystalv0.6.1

Local-first memory for AI coding conversations: imports chats from coding assistants into notes with semantic search, tag graphs and Markdown export.

60Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active19d ago

Install ChatCrystal MCP server

claude mcp add zengliangyi -e CHATCRYSTAL_API_TOKEN='<chatcrystal-api-token>' -- npx -y chatcrystal mcp

{
  "mcpServers": {
    "zengliangyi": {
      "command": "npx",
      "args": [
        "-y",
        "chatcrystal",
        "mcp"
      ],
      "env": {
        "CHATCRYSTAL_API_TOKEN": "<chatcrystal-api-token>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "zengliangyi": {
      "command": "npx",
      "args": [
        "-y",
        "chatcrystal",
        "mcp"
      ],
      "env": {
        "CHATCRYSTAL_API_TOKEN": "<chatcrystal-api-token>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "zengliangyi": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "chatcrystal",
        "mcp"
      ],
      "env": {
        "CHATCRYSTAL_API_TOKEN": "<chatcrystal-api-token>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "zengliangyi": {
      "command": "npx",
      "args": [
        "-y",
        "chatcrystal",
        "mcp"
      ],
      "env": {
        "CHATCRYSTAL_API_TOKEN": "<chatcrystal-api-token>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
CHATCRYSTAL_BASE_URL	—	—	Optional ChatCrystal Core URL. Leave empty to use the local default at http://localhost:3721.
CHATCRYSTAL_API_TOKEN	—	yes	Optional token for a protected ChatCrystal Cloud or remote instance.

Freshness

Active — last maintenance signal 19d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-09-20 · 19d ago · GitHub
Latest release
2026-09-20 · 19d ago · GitHub · v0.6.1
Package published
no data · npm/PyPI
Registry entry updated
2026-09-20 · 19d ago · official registry · v0.6.1

FAQ

›How do I install the ChatCrystal MCP server in Claude Code?

Run: claude mcp add zengliangyi -e CHATCRYSTAL_API_TOKEN='<chatcrystal-api-token>' -- npx -y chatcrystal mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does ChatCrystal require an API key?

Yes. It expects CHATCRYSTAL_API_TOKEN, of which 1 is a secret.

›Can I use ChatCrystal as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is ChatCrystal in the official MCP registry?

Yes, as io.github.ZengLiangYi/chatcrystal.