ChatCrystal MCP Server

Local-first AI PKM memory for coding conversations.

Local serverstdio

What is the ChatCrystal MCP Server?

Local-first AI PKM memory for coding conversations.

What the server does

ChatCrystal is a local-first AI PKM app for developers who solve real problems with Claude Code, Cursor, Codex CLI, Trae, and GitHub Copilot.

  • Imports AI coding conversations — from local tool data directories
  • Distills conversations into structured notes — with titles, summaries, conclusions, snippets, and tags
  • Searches knowledge semantically — with embeddings and relation-aware result expansion
  • Builds a tag knowledge graph — where knowledge points are tags and edges show normalized co-occurrence
  • Exposes CLI and MCP tools — so agents can recall and write back reusable experience
  • Runs locally — with configurable LLM and embedding providers

Credentials and setup notes

  • Node.js >= 20 - An LLM provider for summarization - An embedding provider for semantic search LLM and embedding providers are configured separately. Large language models such as Claude, GPT, and Qwen are not embedding models. See the user guide for provider examples.

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

How to install the ChatCrystal MCP Server

{
  "mcpServers": {
    "chatcrystal": {
      "command": "npx",
      "args": ["-y", "chatcrystal"],
      "env": {
        "CHATCRYSTAL_API_TOKEN": "your-value",
        "CHATCRYSTAL_DOCKER_LLM_BASE_URL": "your-value",
        "CHATCRYSTAL_DOCKER_EMBEDDING_BASE_URL": "your-value"
      }
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

  • Node.js >= 20 - An LLM provider for summarization - An embedding provider for semantic search LLM and embedding providers are configured separately. Large language models such as Claude, GPT, and Qwen are not embedding models. See the user guide for provider examples.
VariableDescriptionRequired
CHATCRYSTAL_API_TOKENCredential the server authenticates with.Yes
CHATCRYSTAL_DOCKER_LLM_BASE_URLEndpoint or connection string the server talks to.Yes
CHATCRYSTAL_DOCKER_EMBEDDING_BASE_URLEndpoint or connection string the server talks to.Yes

Frequently asked questions

Local-first AI PKM memory for coding conversations. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.