Skip to main content
Claude Code + Supermemory
This integration requires the Supermemory Pro plan. Upgrade here.
Claude-Supermemory is a Claude Code plugin that gives your AI persistent memory across sessions. Your agent remembers what you worked on — across sessions, across projects.

Get Your API Key

Create a Supermemory API key from the API Keys page, then add it to your shell profile so it persists across sessions:
echo 'export SUPERMEMORY_CC_API_KEY="sm_..."' >> ~/.zshrc
source ~/.zshrc

Install the Plugin

# Add the plugin marketplace
/plugin marketplace add supermemoryai/claude-supermemory

# Install the plugin
/plugin install claude-supermemory

How It Works

Once installed, the plugin runs automatically:
  • Context Injection — On session start, relevant memories are fetched and injected into Claude’s context. This includes user preferences, project knowledge, and past interactions.
  • Auto-Capture — Tool usage is captured and stored during the session for future context.

What Gets Captured

ToolCaptured As
EditEdited src/auth.ts: "old code..." → "new code..."
WriteCreated src/new-file.ts (500 chars)
BashRan: npm test (SUCCESS/FAILED)
TaskSpawned agent: explore codebase

Commands

/claude-supermemory:logout

Log out from Supermemory and clear saved credentials.
/claude-supermemory:logout

Configuration

Environment Variables

SUPERMEMORY_CC_API_KEY=sm_...         # Required
SUPERMEMORY_SKIP_TOOLS=Read,Glob,Grep # Tools to not capture (optional)
SUPERMEMORY_DEBUG=true                # Enable debug logging (optional)

Settings File

Create ~/.supermemory-claude/settings.json:
{
  "skipTools": ["Read", "Glob", "Grep", "TodoWrite"],
  "captureTools": ["Edit", "Write", "Bash", "Task"],
  "maxContextMemories": 10,
  "maxProjectMemories": 20,
  "debug": false
}

Next Steps