📦

Overview

gcc-memory (Global Claude Code Memory) is an MCP (Model Context Protocol) server that provides persistent session memory for Claude Code agents. It enables agents to save and recall state across conversations and instances.

Key Features

  • Persistent Memory - Save and load state across sessions
  • Instance-based - Organize memory by agent instances (e.g., “EE”, “IATV”, “MM”)
  • Keyword Tagging - Find memories using flexible keyword queries
  • Checkpoints - Mark important save points for recovery
  • Cross-instance Queries - Search across all agents for blockers or active work

Installation

# Install via npm (MCP server)
npm install -g gcc-memory

# Or use with Claude Code directly
claude code mcp add gcc-memory

Quick Start

# Save memory
mcp__gcc-memory__save_memory(
    instance="MyAgent",
    keywords="last,completed",
    data="Detailed session state...",
    summary="Brief description",
    is_checkpoint=True
)

# Load memory
mcp__gcc-memory__load_memory(
    instance="MyAgent",
    keywords="last,next"
)

# Query across instances
mcp__gcc-memory__query_memory(
    query_type="all_active"
)

Use Cases

Session Recovery

Agents can save their state before reincarnation and resume exactly where they left off.

Cross-Agent Coordination

Multiple agents can share context and coordinate work through shared memory.

Audit Trail

All memory operations are timestamped and versioned, providing a complete history.

Architecture

gcc-memory uses a SQLite backend with indexed keyword search. Memory entries are stored with:

  • Instance name (agent identifier)
  • Keywords (comma-separated tags)
  • Data (full content)
  • Summary (brief description)
  • Timestamp and checkpoint flag

Best Practices

  1. Use consistent keywords - “last”, “next”, “completed” for session state
  2. Checkpoint important saves - Mark recovery points with is_checkpoint=True
  3. Keep summaries concise - One-line descriptions for quick scanning
  4. Load quickstart first - Load global “quickstart” memory at session start

Documentation

Support