Claude Code - Memory Crystal

Recommended: universal installer

Use the universal installer first. It can configure this target for hosted cloud or local Docker Convex and creates config backups before writing.

Agent Instructions

Copy and paste this directly into Claude Code:

Install Memory Crystal for Claude Code. Run the official installer command for this machine, follow the auth/backend prompts, and do not manually edit Claude config unless the installer fails and asks for a manual fallback. After installation, reopen Claude Code and confirm Memory Crystal MCP tools are available.

macOS/Linux/WSL:
curl -fsSL https://memorycrystal.ai/crystal | bash -s -- --targets claude-code

Windows PowerShell:
iwr https://memorycrystal.ai/install.ps1 -OutFile install.ps1; .\install.ps1 -Targets claude-code

curl -fsSL https://memorycrystal.ai/crystal | bash -s -- --targets claude-code

For native Windows PowerShell, use:

iwr https://memorycrystal.ai/install.ps1 -OutFile install.ps1
.\install.ps1 -Targets claude-code

For local data storage, add --backend local in Bash or -Backend local in PowerShell. See Local-First Setup. Claude Code can plug into Memory Crystal so it can ask for memories it learned before instead of starting from zero every run.

What this means in practice

Claude Code uses the current Streamable HTTP MCP path. In this repo, that means you can either:

run the Claude-specific installer
or register the MCP endpoint yourself

How it actually works

Important repo surfaces:

apps/web/public/install-claude-mcp.sh
packages/mcp-server/README.md
.env.example

The installer is responsible for:

detecting the Claude CLI
handling device/browser authorization or manual API-key entry
registering the Memory Crystal MCP endpoint
storing local Memory Crystal support files under ~/.memory-crystal

Universal installer path

The recommended first install path is the universal installer:

curl -fsSL https://memorycrystal.ai/crystal | bash

Use it when you want Memory Crystal to detect Claude Code, ask before changing config, and offer cloud or local-first backend mode. The dedicated commands below remain useful for single-client installs and compatibility.

Commands / examples

Installer:

curl -fsSL https://memorycrystal.ai/install-claude-mcp.sh | bash

Direct registration:

claude mcp add memory-crystal --transport http http://localhost:3100/mcp

Uninstall

curl -fsSL https://memorycrystal.ai/uninstall-claude-mcp.sh | bash

For purge behavior and safety notes, see the uninstall guide.

Common mistakes

following the deprecated Claude Desktop path instead of the Claude Code path
confusing local server examples with hosted endpoint usage
forgetting to provide the API key/backend URL when bypassing the installer

Source of truth

Primary files behind this page:

apps/web/public/install-claude-mcp.sh
packages/mcp-server/README.md
.env.example

​Recommended: universal installer

​Agent Instructions

​What this means in practice

​How it actually works

​Universal installer path

​Commands / examples

​Uninstall

​Common mistakes

​Source of truth