Claude Recall

v1.0.0Knowledge & Memorystable

A persistent memory server for Claude Code that captures session context and tool outputs to inject relevant history into future sessions. It enables long-term recall through semantic search and automatic context management, allowing for more consist

aiclaudeclaude-codemcpmemory
Share:
250
Stars
0
Downloads
0
Weekly
0/5

What is Claude Recall?

Claude Recall is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to persistent memory server for claude code that captures session context and tool outputs to inject relevant history into future sessions. it enables long-term recall through semantic search and automat...

A persistent memory server for Claude Code that captures session context and tool outputs to inject relevant history into future sessions. It enables long-term recall through semantic search and automatic context management, allowing for more consist

This server falls under the Knowledge & Memory category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • A persistent memory server for Claude Code that captures ses

Use Cases

Create persistent Claude Code memory
Inject relevant history into sessions
Enable long-term context recall
nhevers

Maintainer

LicenseISC License
Languagetypescript
Versionv1.0.0
UpdatedMay 18, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx claude-recall

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Claude Recall

Claude Recall (MoltBrain) is a persistent memory server for Claude Code that automatically captures session observations — including tool outputs, design decisions, and discovered code patterns — and stores them with semantic vector embeddings so they can be retrieved in future sessions. It uses ChromaDB for vector storage and exposes a local web viewer and REST API at localhost:37777, giving developers a searchable timeline of everything Claude has learned across projects. By injecting relevant past context into new sessions automatically, it enables more consistent long-running workflows where Claude remembers architectural decisions and project-specific conventions.

Prerequisites

  • Node.js 18 or higher, or Bun 1.0 or higher
  • Claude Code installed and configured
  • ChromaDB accessible (bundled or separately installed) for vector embeddings
  • MoltBrain plugin installed via the Claude Code plugin marketplace
  • Optional: ANTHROPIC_API_KEY if using Claude as the summary model
1

Install MoltBrain via the Claude Code plugin marketplace

Add the MoltBrain plugin directly from the Claude Code plugin marketplace. The system activates automatically with no additional configuration required after installation.

/plugin marketplace add nhevers/moltbrain
/plugin install moltbrain
2

Verify the worker service is running

After installation, the MoltBrain worker service should start automatically on port 37777. Check the health endpoint to confirm it is active.

curl http://localhost:37777/health
3

Configure settings (optional)

Adjust memory behavior by editing ~/.moltbrain/settings.json. Key settings include the maximum number of memory injections per session and the AI model used for generating summaries.

# ~/.moltbrain/settings.json
{
  "MOLTBRAIN_WORKER_PORT": 37777,
  "MOLTBRAIN_CONTEXT_OBSERVATIONS": 50,
  "MOLTBRAIN_PROVIDER": "claude",
  "MOLTBRAIN_PRUNE_DAYS": 0,
  "MOLTBRAIN_LOG_LEVEL": "info"
}
4

Search stored memories from the CLI

Use the moltbrain CLI to manually search for past observations using semantic search against stored vector embeddings.

moltbrain search "authentication middleware"
moltbrain stats
moltbrain export
5

Organize observations with tags

Tag specific observations to make them easier to find and filter later. Use the observation ID shown in the web viewer or CLI output.

moltbrain tag <observation-id> architecture
moltbrain tag <observation-id> bug-fix
6

Open the web viewer

Browse your full memory timeline, analytics, and session history using the built-in web interface.

open http://localhost:37777

Claude Recall Examples

Client configuration

MCP server configuration for Claude Desktop to connect to the MoltBrain memory worker. The worker must be running locally first.

{
  "mcpServers": {
    "claude-recall": {
      "command": "npx",
      "args": ["claude-recall"],
      "env": {
        "MOLTBRAIN_WORKER_PORT": "37777",
        "MOLTBRAIN_CONTEXT_OBSERVATIONS": "50",
        "MOLTBRAIN_PROVIDER": "claude"
      }
    }
  }
}

Prompts to try

Example prompts that leverage persistent memory in Claude Code sessions

- "What did we decide about the database schema in previous sessions?"
- "Search memory for any notes about the authentication flow"
- "Summarize what you remember about this project's architecture"
- "Tag this observation as a key architectural decision"

Troubleshooting Claude Recall

Worker service not starting or health check fails

Check if port 37777 is already in use with lsof -i :37777. Change MOLTBRAIN_WORKER_PORT in ~/.moltbrain/settings.json if there is a conflict. Also confirm Node.js 18+ is installed with node --version.

Memory observations are not being injected into new sessions

Verify MOLTBRAIN_CONTEXT_OBSERVATIONS is not set to 0. Check that ChromaDB is running and accessible. Run moltbrain stats to confirm observations have been stored from previous sessions.

Semantic search returns irrelevant results

The embedding model improves with more stored observations. Use moltbrain tag to label high-quality observations, and use moltbrain prune to remove low-quality or outdated ones. Try more specific search queries.

Frequently Asked Questions about Claude Recall

What is Claude Recall?

Claude Recall is a Model Context Protocol (MCP) server that persistent memory server for claude code that captures session context and tool outputs to inject relevant history into future sessions. it enables long-term recall through semantic search and automatic context management, allowing for more consist It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Claude Recall?

Follow the installation instructions on the Claude Recall GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Claude Recall?

Claude Recall works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Claude Recall free to use?

Yes, Claude Recall is open source and available under the ISC License license. You can use it freely in both personal and commercial projects.

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.

Quick Config Preview

{ "mcpServers": { "claude-recall": { "command": "npx", "args": ["-y", "claude-recall"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Claude Recall?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides