Memory MCP
What it does
Persistent memory + git snapshots for Claude Code. Never lose context or code.
- Connects Runs on your computer
- Account or key No key needed
- Category Search & AI memory
Install
Pick the AI app you use, then copy the settings.
Passed 2/3 checks · Runs on your computer · ✓ Commands checked Nov 13, 2026
First: which AI do you use?
Pick your app and the steps appear below.
Works with Claude, with some setup first
Install Node.js on your computer first (one time) · Only the Claude desktop app (Windows or Mac), not the web or phone
Let AI install it
Copy this message into a Claude chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.
Please install the MCP server Memory MCP for Claude on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "mcpServers": { "memory": { "command": "npx", "args": [ "-y", "claude-code-memory" ] } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) No key is needed. 5) Do what we agreed, then check that the Memory MCP tools really show up.This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.
Install Node.js (if you don’t have it)
Already installed? Check first · Open Terminal, type this command and press Enter
node -v- A version number such as v26.13.1 = installed, skip this step
- "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
How to open Terminal
Mac: press ⌘ + Space, type Terminal, press Enter
Windows: open Start, type Windows PowerShell, then Open
Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed
Open the Node.js download page ↗
When it’s done, close Terminal, open it again and run the same command. You should see a version number:
node -vInstall once; it works for everything that needs Node.js
Open the Claude desktop app’s settings file
SettingsDeveloperEdit Config
Paste these settings and save the file
{ "mcpServers": { "memory": { "command": "npx", "args": [ "-y", "claude-code-memory" ] } } }Quit Claude and open it again
Try it
Use Memory MCP and tell me what you can do for me, then show me one thing✓ If Claude says it is using Memory MCP or shows a Memory MCP tool in the answer, you are connected
Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version
ChatGPT cannot connect Memory MCP yet
Memory MCP runs on your computer, but ChatGPT can only connect servers that run on the web
What you can do instead
A · Use an app that can connect Memory MCP
- Install Node.js on your computer first (one time) · Only the Claude desktop app (Windows or Mac), not the web or phone
- Install Node.js on your computer first (one time)
- Install Node.js on your computer first (one time)
- Install Node.js on your computer first (one time)
Works with Claude Code, with some setup first
Install Node.js on your computer first (one time)
Let AI install it
Copy this message into a Claude Code chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.
Please install the MCP server Memory MCP for Claude Code on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): claude mcp add --scope user memory -- npx -y claude-code-memory 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) No key is needed. 5) Do what we agreed, then check that the Memory MCP tools really show up.This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.
Install Node.js (if you don’t have it)
Already installed? Check first · Open Terminal, type this command and press Enter
node -v- A version number such as v26.13.1 = installed, skip this step
- "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
How to open Terminal
Mac: press ⌘ + Space, type Terminal, press Enter
Windows: open Start, type Windows PowerShell, then Open
Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed
Open the Node.js download page ↗
When it’s done, close Terminal, open it again and run the same command. You should see a version number:
node -vInstall once; it works for everything that needs Node.js
Open Terminal
Mac: press Command+Space and type Terminal · Windows: open PowerShell
Paste this command and press Enter
claude mcp add --scope user memory -- npx -y claude-code-memoryType /mcp in Claude Code
You should see Memory MCP listed as connected
Try it
Use Memory MCP and tell me what you can do for me, then show me one thing✓ If Claude Code says it is using Memory MCP or shows a Memory MCP tool in the answer, you are connected
Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Works with Cursor, with some setup first
Install Node.js on your computer first (one time)
Let AI install it
Copy this message into a Cursor chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.
Please install the MCP server Memory MCP for Cursor on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "mcpServers": { "memory": { "command": "npx", "args": [ "-y", "claude-code-memory" ] } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) No key is needed. 5) Do what we agreed, then check that the Memory MCP tools really show up.This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.
Install Node.js (if you don’t have it)
Already installed? Check first · Open Terminal, type this command and press Enter
node -v- A version number such as v26.13.1 = installed, skip this step
- "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
How to open Terminal
Mac: press ⌘ + Space, type Terminal, press Enter
Windows: open Start, type Windows PowerShell, then Open
Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed
Open the Node.js download page ↗
When it’s done, close Terminal, open it again and run the same command. You should see a version number:
node -vInstall once; it works for everything that needs Node.js
Open the AI chat in Cursor in Agent mode
Try it
Use Memory MCP and tell me what you can do for me, then show me one thing✓ If Cursor says it is using Memory MCP or shows a Memory MCP tool in the answer, you are connected
Menu names checked against Cursor’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Works with VS Code, with some setup first
Install Node.js on your computer first (one time)
Let AI install it
Copy this message into a VS Code chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.
Please install the MCP server Memory MCP for VS Code on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "servers": { "memory": { "type": "stdio", "command": "npx", "args": [ "-y", "claude-code-memory" ] } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) No key is needed. 5) Do what we agreed, then check that the Memory MCP tools really show up.This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.
Install Node.js (if you don’t have it)
Already installed? Check first · Open Terminal, type this command and press Enter
node -v- A version number such as v26.13.1 = installed, skip this step
- "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
How to open Terminal
Mac: press ⌘ + Space, type Terminal, press Enter
Windows: open Start, type Windows PowerShell, then Open
Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed
Open the Node.js download page ↗
When it’s done, close Terminal, open it again and run the same command. You should see a version number:
node -vInstall once; it works for everything that needs Node.js
Open the AI chat in VS Code in Agent mode
Try it
Use Memory MCP and tell me what you can do for me, then show me one thing✓ If VS Code says it is using Memory MCP or shows a Memory MCP tool in the answer, you are connected
Menu names checked against VS Code’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Other apps that use MCP, such as Windsurf, Zed or Gemini CLI, each add servers differently. See how in the app list.
JSON settings are under “For developers” below
For developers: Terminal commands and JSON settings
Installed on your computer
Claude Code
claude mcp add --scope user memory -- npx -y claude-code-memoryClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"memory": {
"command": "npx",
"args": [
"-y",
"claude-code-memory"
]
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"memory": {
"command": "npx",
"args": [
"-y",
"claude-code-memory"
]
}
}
}VS Code (mcp.json)
{
"servers": {
"memory": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"claude-code-memory"
]
}
}
}These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.
At a glance
Which apps can use it
Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.
Run on your computer in
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
Related guides
What it can do
Runs on your computer; the tool list appears in your AI app after you install it.
Basic checksi
We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 15, 2026
- ✓ Pass
Maker matches the repo
The registry name was verified with the GitHub account yuvalsuede, which owns the repo
- ! Caution
Still maintained
Code last changed 10 months ago, more than 6 months ago
- ✓ Pass
Has a licence
Uses MIT
- – Not applicable
Endpoint responds
This one runs on your computer; there is no internet endpoint
- – Not applicable
Sign-in with OAuth
Runs on your computer and uses local settings instead
- … Not checked yet
No hidden instructions in tool descriptions
Runs on your computer; we can only read tool lists from internet endpoints
Published vulnerabilities (OSV.dev)
No entries on OSV.dev for claude-code-memory@1.2.1
Checks only this package version, not every dependency · checked Nov 15, 2026
Makers: ask for a re-check or report wrong info
Discussion
Ask, share a tip or report that it does not work. Sorted by what people marked helpful.
No posts yet. Be the first to ask or share.
Posts here are written by users, not the PopNx team.
User reviews
No reviews yet
Compared with others in Search & AI memoryi
- More stars than 97% of the other 6171 servers in this category
- Published to the registry more recently than 2% of the other 6171 servers in this category
- Basic checks equal to or better than 50% of the other 6171 servers in this category
Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.
Common questions
Is Memory MCP safe?
It passed 2 of 3 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.
What keys or codes does it need?
The registry does not list a required key, though some servers ask you to sign in on first use.
Does it run on my computer or in the cloud?
It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).
Is it still maintained?
The GitHub repo last changed 10 months ago, and the latest version (1.2.1) reached the registry 10 months ago.
Which apps can use it?
Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Node.js on your computer.
What can I use instead?
In the same category: OpenSEO, Exa, Mockserver, Microsoft Learn MCP, Docs
Similar alternatives
Same category, other makers, commands already checked. Official ones first, then by stars.
Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi
Exa
Connect AI agents to Exa for web search, content fetching, and multi-step research.
Mockserver
Mock, record/replay, verify and chaos-test any HTTP, REST, gRPC or LLM dependency over MCP.
Microsoft Learn MCP
Official Microsoft Learn MCP Server – real-time, trusted docs & code samples for AI and LLMs.
Docs
Search and read Empryo's documentation. Read-only, no auth, no local access.
- OpenSEO — Runs in the cloud, nothing to install · No key needed
- Exa — Runs in the cloud, nothing to install · No key needed · In Claude’s directory
- Mockserver — Installs on your computer · No key needed
- Microsoft Learn MCP — Runs in the cloud, nothing to install · No key needed · In Claude’s directory
- Docs — Runs in the cloud, nothing to install · No key needed
README from the maker
Open the README
Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.
memory-mcp
Persistent memory + automatic git snapshots for Claude Code. Never lose context. Never lose code.
🧠 45 memories | 📊 2.8K tokens | 📸 23 snapshots | ⏱️ 5m ago
Why memory-mcp?
| Problem | Solution |
|---|---|
| Re-explaining your project every session | Auto-captures decisions, patterns, architecture |
| Context window fills up, knowledge lost | Two-tier memory: CLAUDE.md (instant) + deep search |
| Broke something, can't remember what worked | Git snapshots on every save, instant rollback |
| No idea what Claude "knows" about your project | Visual dashboard shows all context |
| Worried about cloud storage | 100% local files, your git repo |
What makes it different
- Git Snapshots — Every memory save commits your entire project. Roll back anytime.
- Two-Tier Memory — CLAUDE.md loads instantly, deep store searchable mid-conversation.
- LLM-Powered — Haiku extracts what matters, consolidates duplicates, prunes stale info.
- Visual Dashboard — See your context: tokens, memories by type, snapshot history.
- Zero friction — No commands to run. It just works silently.
Quick Start
# Install globally
npm install -g claude-code-memory
Interactive setup (API key + hooks)
memory-mcp setup
Initialize a project
memory-mcp init ~/Projects/my-app
That's it. Start coding. Memories accumulate automatically.
How It Works
graph TB
subgraph "Phase 1: Silent Capture" A[Claude Code Session] -->|User sends message| B[Claude responds] B -->|Hook fires: Stop/PreCompact/SessionEnd| C[extractor.js] C --> D[Read transcript from cursor] D --> E[Chunk if >6000 chars] E --> F[Send to Haiku LLM] F -->|Extract memories as JSON| G[Dedup via Jaccard similarity] G --> H[Save to .memory/state.json] H --> I[Decay confidence scores] I --> J{Consolidation needed?} J -->|>80 memories or every 10 extractions| K[Haiku merges/drops] J -->|No| L[Sync CLAUDE.md] K --> L end
subgraph "Phase 2: Recovery" M[New session starts] -->|Built-in behavior| N[Claude reads CLAUDE.md] N --> O[Claude has full project context] end
subgraph "Phase 3: Deep Recall" O --> P{Need specific context?} P -->|memory_search| Q[Keyword search across memories] P -->|memory_ask| R[Haiku synthesizes answer from top 30 matches] P -->|memory_related| S[Tag-based retrieval] end
subgraph "Data Store" H -.-> T[(.memory/state.json Full memory store)] L -.-> U[(CLAUDE.md ~150 line summary)] T -.->|MCP tools read| Q T -.->|MCP tools read| R T -.->|MCP tools read| S end
style A fill:#4a9eff,color:#fff style F fill:#ff6b6b,color:#fff style K fill:#ff6b6b,color:#fff style R fill:#ff6b6b,color:#fff style T fill:#ffd93d,color:#000 style U fill:#6bcb77,color:#000
Two-tier memory architecture:
| Layer | Purpose | Size |
|---|---|---|
CLAUDE.md | Auto-read on session start. Top ~150 lines of the most important context. | Compact |
.memory/state.json | Full memory store. Searchable via MCP tools mid-conversation. | Unlimited |
Silent capture via hooks:
Claude Code hooks fire after every response (Stop), before context compaction (PreCompact), and at session end (SessionEnd). A fast LLM (Haiku) reads the transcript and extracts:
- Architecture — how the system is structured
- Decisions — why X was chosen over Y
- Patterns — conventions and how things are done
- Gotchas — non-obvious pitfalls
- Progress — what's done, what's in flight
- Context — business context, deadlines, preferences
Smart memory management:
- Jaccard similarity deduplication (no duplicate memories)
- Confidence decay (progress fades after 7 days, context after 30)
- LLM-powered consolidation (merges overlapping memories, prunes stale ones)
- Line-budgeted CLAUDE.md (stays under ~150 lines, most important first)
Updating
To update an existing installation:
npm install -g claude-code-memory --force
To update hooks (e.g., after a bug fix):
memory-mcp setup
Requirements
- Claude Code CLI
- Node.js 18+
- Anthropic API key (for the Haiku-based extractor, ~$0.001 per extraction)
CLI Commands
memory-mcp setup Interactive first-time setup
memory-mcp init [dir] Initialize memory for a project memory-mcp status [dir] Show memory status and health memory-mcp statusline [dir] Compact one-line status (great for shell prompts) memory-mcp context [dir] Show context metrics and token usage memory-mcp context --html Generate visual HTML dashboard memory-mcp search Search memories by keyword memory-mcp ask Ask a question, get answer from memory memory-mcp consolidate [dir] Merge duplicates, prune stale memories memory-mcp key [api-key] Set or check Anthropic API key memory-mcp snapshots [dir] List git snapshot history memory-mcp snapshot-enable Enable automatic git snapshots memory-mcp snapshot-disable Disable git snapshots memory-mcp help Show help
Context Dashboard
Visualize your memory usage with memory-mcp context:
Context Dashboard
Project: my-app
Total Context 2.8K estimated tokens
Tier 1 CLAUDE.md (auto-loaded) █████████████████░░░░░░░░░░░░░ 1.0K 45 lines, 44 in memory block
Tier 2 .memory/state.json (searchable) ██████████████████████████████ 1.8K 29 active, 5 archived, 24 superseded
Memories by Type architecture ███░░░░░░░░░░░░░░░░░ 8 memories (291 tokens) decision ██████░░░░░░░░░░░░░░ 18 memories (540 tokens) gotcha ████░░░░░░░░░░░░░░░░ 10 memories (332 tokens) progress ██████░░░░░░░░░░░░░░ 19 memories (538 tokens)
Git Snapshots ● Enabled on __memory-snapshots 42 commits → origin
Use memory-mcp context --html to generate an interactive browser dashboard.
Git Snapshots
Automatic project versioning tied to your working sessions. Every memory extraction commits your entire project to a hidden branch.
# Enable during init (you'll be prompted)
memory-mcp init ~/Projects/my-app
Or enable later
memory-mcp snapshot-enable
View snapshot history
memory-mcp snapshots
Compare two snapshots
memory-mcp snapshot-diff abc123 def456
Restore to a previous state
memory-mcp snapshot-restore abc123
Disable (preserves existing snapshots)
memory-mcp snapshot-disable
How it works:
- Commits go to
__memory-snapshotsbranch (invisible in normal workflow) - Optional push to remote (e.g., origin)
- Commit messages include what memories were extracted
- Full project state captured, not just memory files
Use cases:
- Roll back after breaking changes
- See what your project looked like during a specific session
- Track project evolution alongside context evolution
MCP Tools (used by Claude mid-conversation)
When configured as an MCP server, Claude can access these tools during a session:
| Tool | Description |
|---|---|
memory_search | Keyword search across all memories |
memory_related | Get memories by tag or area |
memory_ask | Ask a question, get an LLM-synthesized answer from memory |
memory_save | Manually save a memory |
memory_recall | List all memories with filters |
memory_delete | Remove a memory |
memory_consolidate | Trigger memory consolidation |
memory_consciousness | Generate the full consciousness document |
memory_stats | Show memory statistics |
memory_init | Set project name and description |
What Gets Stored
Memories are categorized into six types:
architecture "Next.js 14 app router with Supabase backend, Stripe for billing"
decision "Chose server components for public pages because of SEO requirements" pattern "All API routes validate input with zod and return NextResponse" gotcha "Supabase RLS policy on word_lists requires user_id OR org_id, not both" progress "Auth complete, billing webhook handling in progress" context "Client wants launch by March, focus on core features only"
File Structure
After initialization, your project gets:
your-project/
├── CLAUDE.md ← auto-updated memory summary (read on session start) ├── .memory/ │ ├── state.json ← full memory store │ └── cursor.json ← tracks what's been processed ├── .mcp.json ← MCP server configuration └── .claude/ └── settings.json ← hook configuration
CLAUDE.md Format
The memory block is inserted between markers, preserving any existing CLAUDE.md content:
<!-- MEMORY:START -->
MyProject
A brief description
_Last updated: 2026-01-27 | 45 active memories, 62 total_
Architecture
- Next.js 14 app router with Supabase backend
- Auth via NextAuth with Google and email providers
Key Decisions
- Chose server components for SEO pages
- Using Supabase RLS instead of API-level auth
Patterns & Conventions
- All API routes use zod validation
- Tailwind only, no CSS modules
Gotchas & Pitfalls
- RLS policy requires user_id OR org_id, not both
Current Progress
- Auth: complete
- Billing: in progress
Context
- Launch target: March
_For deeper context, use memory_search, memory_related, or memory_ask tools._
Global vs Per-Project Install
Global (recommended): hooks work for all projects automatically.
memory-mcp setup # select "global" when prompted
Per-project: hooks and MCP configured per project.
memory-mcp init /path/to/project
Configuration
API key is resolved in order:
ANTHROPIC_API_KEYenvironment variable~/.memory-mcp/config.json~/.config/anthropic/api_key~/.anthropic/api_key
Cost
The extractor uses Claude Haiku for memory extraction and consolidation. Typical cost:
- ~$0.001 per extraction (after each Claude response)
- ~$0.005 per consolidation (every ~10 extractions)
- A full day of coding: ~$0.05–0.10
License
MIT