Memory MCP server
io.github.sharedmemoryai/memory·v2.1.1·1 starsPersistent memory for AI agents. Remember, recall, and explore a shared knowledge graph.
1 stars49 downloads/wk
Reviews
Write oneNobody has reviewed Memory yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Memory tools (12, 1 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
batch_rememberStore multiple facts or pieces of information at once. More efficient than calling remember() in a loop.
explore_graphGet an overview of the entire knowledge graph for a volume. Shows all entities and their relationships — like a map of everything SharedMemory knows.
get_contextAssemble a smart context block from stored memories. Returns a pre-formatted context string ready to inject into a system prompt.
get_entityGet everything SharedMemory knows about a specific entity (person, project, concept, etc). Returns the summary, all facts, and relationships.
get_memoryRetrieve a specific memory by its ID. Useful for viewing the full details of a memory found via recall.
get_profileGet an auto-generated profile for a user based on their stored memories. Returns stable facts, recent activity, relationships, and a summary.
list_documentsList all documents that have been uploaded and processed for a volume.
list_volumesList all memory volumes (projects) this API key has access to. Each volume is an independent memory space.
manage_memorywrite actionDelete or update an existing memory by ID.
recallSearch SharedMemory for relevant memories using semantic similarity. Returns matching memories from vector search + related knowledge graph facts.
rememberStore a fact, note, or piece of information in SharedMemory. The memory pipeline will classify it, check for conflicts, extract knowledge, and build the graph automatically.
search_entitiesSearch for entities in the knowledge graph by name. Useful for finding people, projects, concepts, etc.
Public scan report
scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it
- Code scan8 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 134 days ago8/15
- Maintainer identityregistry namespace matches repository owner7/10
How Memory compares
Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 71/100
- higher than 36% of 48,255 servers
- Tools
- 12
- the typical server has 7
- Tools that change things
- 8%
- typical: 0%. Fewer write tools means less an agent can break
- GitHub stars
- 1
- more than 65% of 28,688 servers
- Downloads a week
- 49
- more than 41% of 12,191 servers with a package
What its tools let an agent do: 11 read · 1 change
Install Memory in Claude Code, Cursor or VS Code
Runs npx -y @sharedmemory/mcp-server on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add memory -- npx -y @sharedmemory/mcp-server
What the publisher says
From the Memory repository's README, as published. We do not edit it. Read it on GitHub
@sharedmemory/mcp-server
Model Context Protocol server for SharedMemory. Gives Claude Code, Claude Desktop, Cursor, VS Code Copilot, and other MCP-compatible tools persistent memory.
Quick Install (Recommended)
The fastest way to set up SharedMemory — one command, no JSON editing:
# Interactive — picks your client, asks for your API key
npx -y @sharedmemory/mcp-server install
# Or specify everything inline
npx -y @sharedmemory/mcp-server install --cursor --api-key sm_live_... --volume your-volume-id
# Install for all supported clients at once
npx -y @sharedmemory/mcp-server install --all --api-key sm_live_...Supported clients: --claude-code, --claude, --cursor, --vscode, --windsurf, --all
Manual Setup
If you prefer to edit config files yourself:
Claude Code
One command:
claude mcp add sharedmemory -- npx -y @sharedmemory/mcp-serverOr with env vars:
claude mcp add --env SHAREDMEMORY_API_KEY=sm_live_... \
--env SHAREDMEMORY_VOLUME_ID=your-volume-id \
sharedmemory -- npx -y @sharedmemory/mcp-serverOr create .mcp.json in your project root to share with your team:
{
"mcpServers": {
"sharedmemory": {
"command": "npx",
"args": ["-y", "@sharedmemory/mcp-server"],
"env": {
"SHAREDMEMORY_API_KEY": "${SHAREDMEMORY_API_KEY}",
"SHAREDMEMORY_API_URL": "https://api.sharedmemory.ai",
"SHAREDMEMORY_VOLUME_ID": "${SHAREDMEMORY_VOLUME_ID}"
}
}
}
}Tip: Copy the included CLAUDE.md into your project root to teach Claude Code when and how to use SharedMemory proactively.
Claude Desktop
~/Library/Application Support/Claude/claudedesktopconfig.json:
{
"mcpServers": {
"sharedmemory": {
"command": "npx",
"args": ["-y", "@sharedmemory/mcp-server"],
"env": {
"SHAREDMEMORY_API_KEY": "sm_live_...",
"SHAREDMEMORY_API_URL": "https://api.sharedmemory.ai",
"SHAREDMEMORY_VOLUME_ID": "your-volume-id"
}
}
}
}Cursor
.cursor/mcp.json in your project root:
{
"mcpServers": {
"sharedmemory": {
"command": "npx",
"args": ["-y", "@sharedmemory/mcp-server"],
"env": {
"SHAREDMEMORY_API_KEY": "sm_live_...",
"SHAREDMEMORY_API_URL": "https://api.sharedmemory.ai",
"SHAREDMEMORY_VOLUME_ID": "your-volume-id"
}
}
}
}VS Code Copilot
.vscode/mcp.json:
{
"servers": {
"sharedmemory": {
"command": "npx",
"args": ["-y", "@sharedmemory/mcp-server"],
"env": {
"SHAREDMEMORY_API_KEY": "sm_live_...",
"SHAREDMEMORY_API_URL": "https://api.sharedmemory.ai",
"SHAREDMEMORY_VOLUME_ID": "your-volume-id"
}
}
}
}Windsurf
~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"sharedmemory": {
"command": "npx",
"args": ["-y", "@sharedmemory/mcp-server"],
"env": {
"SHAREDMEMORY_API_KEY": "sm_live_...",
"SHAREDMEMORY_API_URL": "https://api.sharedmemory.ai",
"SHAREDMEMORY_VOLUME_ID": "your-volume-id"
}
}
}
}Configuration
Available tools
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Memory: common questions
- Is Memory MCP server safe?
- Mostly: it is graded B (71/100). Read the Memory safety report
- How do I install Memory?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Memory need an API key?
- Yes. The registry entry asks for
SHAREDMEMORY_API_KEY. - Is Memory maintained?
- The last commit was 171 days ago (2026-05-17). The latest release is v2.1.1.
- What can I use instead of Memory?
- Servers from other publishers that do the same job: Codebase Memory MCP server, Neo4j Memory MCP server and State Memory MCP server.
- How does Memory compare with other MCP servers?
- safety score 71/100 (higher than 36% of 48,255 servers); tools 12 (the typical server has 7); tools that change things 8% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.
Alternatives to Memory
Same job from other publishers: the closest match first, then the best rated.
- Codebase MemoryCodebase knowledge graph for AI agents — 162 languages, sub-ms queries, 99% fewer tokens.not reviewedWidely usedC
- Neo4j MemoryMCP Neo4j Knowledge Graph Memory Servernot reviewedEstablishedA
State Memory MCPPersistent workflow graph server tracking tasks, decisions, spatial entities, and blockers.not reviewedEstablishedA
KnowlPersistent memory for AI agents, for code, research and everyday life. Stale facts retire.not reviewedEstablishedA