Claude Memory Manager MCP server

Claude Memory Manager

<!-- mcp-name: io.github.NyxToolsDev/claude-memory-manager -->

Cross-session memory for Claude Code — never lose context between sessions.

Claude Memory Manager automatically captures architectural decisions, code changes, bug fixes, and configuration choices from your Claude Code sessions, then intelligently retrieves relevant context when you start new sessions.

What It Does

Every time you use Claude Code, valuable context is created and lost when the session ends:

• Which libraries you chose and why
• Bug fixes and their root causes
• Configuration decisions
• File structure and naming conventions
• Error resolutions

Claude Memory Manager solves this by:

1. Parsing your Claude Code session logs (JSONL files)
2. Extracting meaningful memories with importance scoring
3. Embedding memories for semantic search
4. Storing everything in a local SQLite database with FTS5
5. Retrieving relevant context via hybrid semantic + keyword search
6. Serving context to Claude Desktop via MCP protocol

Installation

pip install claude-memory-manager

For local embeddings (no API key needed):

pip install claude-memory-manager[local]

For development:

pip install claude-memory-manager[dev]

Quick Start

1. Initialize the Database

claude-memory init

This creates the SQLite database at ~/.claude-memory/memory.db and saves a config file.

2. Ingest Session Logs

# Ingest all sessions from the default path (~/.claude/projects/)
claude-memory ingest

# Ingest from a specific path
claude-memory ingest /path/to/sessions

# Watch for new sessions and auto-ingest
claude-memory ingest --watch

3. Search Memories

# Search across all memories
claude-memory search "authentication setup"

# Filter by project
claude-memory search "database schema" --project /path/to/project

# Filter by category
claude-memory search "cors" --category config

4. Generate Context Summary

# List all indexed projects
claude-memory context

# Generate summary for a specific project
claude-memory context /path/to/project

# With custom token limit
claude-memory context /path/to/project --max-tokens 3000

5. Connect to Claude Desktop (MCP)

Add to your Claude Desktop config (see MCP Setup):

{
  "mcpServers": {
    "claude-memory": {
      "command": "claude-memory-mcp",
      "args": []
    }
  }
}

CLI Reference

Global Options

Search Options

Categories

Memories are classified into these categories:

• decision — Architectural and design decisions
• code_change — Significant code modifications
• bug_fix — Bug identification and resolution
• config — Configuration and environment changes
• error_resolution — Errors encountered and solved
• preference — User preferences and conventions
• discussion — General discussion summaries

MCP Setup

Shortened. The full README is on GitHub.