Spool
Your local AI session library. Collects sessions from Claude Code, Codex CLI, Gemini CLI (and more) — browsable and ⌘K-searchable.
What is Spool?
Spool is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to your local ai session library. collects sessions from claude code, codex cli, gemini cli (and more) — browsable and ⌘k-searchable.
Your local AI session library. Collects sessions from Claude Code, Codex CLI, Gemini CLI (and more) — browsable and ⌘K-searchable.
This server falls under the Knowledge & Memory category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Your local AI session library. Collects sessions from Claude
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx spoolConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Spool
Spool is a local-first Electron desktop app (macOS and Linux) that indexes every Claude Code, Codex CLI, Gemini CLI, and OpenCode session stored on your machine into a searchable library, organized by working-directory project. It offers real-time session watching, pinned sessions, command-K full-text and AI-mode search, a built-in security scanner that surfaces leaked API keys and PII across all sessions with one-click rotation links, and a /spool skill for injecting matching session fragments directly into active Claude Code conversations. Nothing leaves your machine.
Prerequisites
- macOS (arm64) or Linux (x86_64) — Windows is not yet supported
- At least one of: Claude Code, Codex CLI, Gemini CLI, or OpenCode installed and having recorded sessions
- pnpm (for building from source) or a prebuilt DMG / AppImage from the Releases page
- No API keys or cloud accounts required — fully local
Install Spool
The fastest path on macOS is the official install script. Alternatively download the DMG (macOS arm64) or AppImage (Linux x86_64) from the GitHub Releases page, or build from source with pnpm.
curl -fsSL https://spool.pro/install.sh | bashLaunch the app and let it index your sessions
Open Spool from your Applications folder (macOS) or run the AppImage. On first launch it watches the default session directories for Claude Code (~/.claude/projects), Codex CLI (~/.codex-profiles/*/sessions), Gemini CLI (~/.gemini/tmp/*/chats), and OpenCode (~/.local/share/opencode/opencode.db). Indexing begins automatically — no configuration needed.
Browse projects and sessions in the sidebar
Spool derives project names from the working-directory paths embedded in your sessions. Click a project in the sidebar to see its sessions sorted by recency. Pin important sessions to keep them at the top of the list across restarts.
Search across all sessions with Command-K
Press Command-K (macOS) to open the search palette. Type any keyword for fast full-text search across all indexed sessions. Switch to AI mode to get synthesized answers drawn from fragments across multiple sessions.
Review the Security Scan results
The always-on security scanner (v0.5.0+) surfaces leaked API keys, tokens, and PII found in any session. Click a finding to see the cross-session blast radius and one-click links to rotate the credential at its source vendor.
Spool Examples
Client configuration
Spool is a desktop app, not a server-based MCP. The /spool skill integration for Claude Code is configured in the MCP settings to allow Claude Code to inject session fragments into the active conversation.
{
"mcpServers": {
"spool": {
"command": "npx",
"args": ["spool"],
"env": {}
}
}
}Prompts to try
Prompts that leverage the Spool session library from inside Claude Code using the /spool skill.
- "Search my past sessions for any work I did on the authentication module."
- "Find sessions from last week where I debugged database connection issues."
- "Show me all sessions related to the checkout-flow project."
- "Did I ever solve a similar TypeScript type error in a previous session?"
- "Find any session where I configured a Docker Compose setup for PostgreSQL."Troubleshooting Spool
Spool crashes at launch with a NODE_MODULE_VERSION mismatch error
This is caused by better-sqlite3 being compiled for the wrong Node.js version. If running from source, run pnpm exec electron-rebuild -f -w better-sqlite3 after any pnpm install or Node.js version switch before launching the Electron app.
Sessions from Claude Code or Codex are not appearing in Spool
Verify the session directories exist: ~/.claude/projects for Claude Code, ~/.codex-profiles/*/sessions for Codex, ~/.gemini/tmp/*/chats for Gemini. Spool watches these in real time — existing sessions may take a moment to index on first launch.
The Security Scan shows false positives or misses real secrets
The scanner uses the @spool-lab/redact regex library. False positives on long random strings are normal. For missed secrets, check that the session containing the key has been indexed (visible in the library). You can also report patterns via GitHub Issues.
Frequently Asked Questions about Spool
What is Spool?
Spool is a Model Context Protocol (MCP) server that your local ai session library. collects sessions from claude code, codex cli, gemini cli (and more) — browsable and ⌘k-searchable. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Spool?
Follow the installation instructions on the Spool GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Spool?
Spool works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Spool free to use?
Yes, Spool is open source and available under the NOASSERTION license. You can use it freely in both personal and commercial projects.
Spool Alternatives — Similar Knowledge & Memory Servers
Looking for alternatives to Spool? Here are other popular knowledge & memory servers you can use with Claude, Cursor, and VS Code.
MemPalace
★ 52.6kA local AI memory system that stores all conversations verbatim and organizes them into navigable structures. It provides 19 MCP tools for AI assistants to search and retrieve past decisions, debugging sessions, and architecture debates automatically
Kratos
★ 25.7k🏛️ Memory System for AI Coding Tools - Never explain your codebase again. MCP server with perfect project isolation, 95.8% context accuracy, and the Four Pillars Framework.
Context Mode
★ 15.4kAn MCP server that preserves LLM context by intercepting large data outputs and returning only concise summaries or relevant sections. It enables efficient sandboxed code execution, file processing, and documentation indexing across multiple programm
Memu
★ 13.7kMemory for 24/7 proactive agents like OpenClaw.
MemOS
★ 9.3kMemOS (Memory Operating System) is a memory management operating system designed for AI applications. Its goal is: to enable your AI system to have long-term memory like a human, not only remembering what users have said but also actively invoking, u
Everos
★ 5.4kBuild, evaluate, and integrate long-term memory for self-evolving agents.
Browse More Knowledge & Memory MCP Servers
Explore all knowledge & memory servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Spool in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Spool?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.