Memory

io.github.sharedmemoryaiPublished by GitHub account sharedmemoryaiv2.1.1Updated Oct 24, 2026

Persistent memory for AI agents. Remember, recall, and explore a shared knowledge graph.

The publisher's own server: Memory.fit

VerifiedSTDIODesktop onlyKnowledge & MemoryAI & ML

Overview

AI-generated overview

SharedMemory's local MCP server gives an assistant persistent memory: it stores facts, recalls them by semantic search, and explores a shared knowledge graph.

What you can do
Store single or batched memories, update or delete them by ID, and submit relevance feedback on results. Retrieve context before answering through semantic search, fetch specific memories, and get a prompt-ready context block or auto-generated user profile. Search entities by name, read entity details and relationships, and view the knowledge graph overview. List accessible volumes, uploaded documents, and active instructions, and set persistent rules all agents follow. Use the knowledge-graph resource and prompts that summarize a volume or report what is known about a topic.
When to use it
Useful when you want an assistant to carry knowledge across sessions and clients, such as coding agents that should remember project facts, preferences, or team rules. Also fits teams sharing one memory volume across Claude Code, Claude Desktop, Cursor, VS Code Copilot, or Windsurf.
Requirements
Runs locally as an npm package via npx, so Node.js is needed. Requires a SharedMemory API key in SHAREDMEMORY_API_KEY; optional SHAREDMEMORY_API_URL and SHAREDMEMORY_VOLUME_ID set the endpoint and default volume. Network access to the SharedMemory API is required.
Before you install
The API key in SHAREDMEMORY_API_KEY is a live credential; keep it out of shared config files and prefer environment-variable references. The assistant can write, update, and delete memories and set instructions that all agents in a volume follow, so review such changes. Stored memories and queries are sent to the SharedMemory cloud service.

Installation

In SourceWeft

  1. Open Memory in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

@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:

bash
# Interactive — picks your client, asks for your API keynpx -y @sharedmemory/mcp-server install
# Or specify everything inlinenpx -y @sharedmemory/mcp-server install --cursor --api-key sm_live_... --volume your-volume-id
# Install for all supported clients at oncenpx -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:

bash
claude mcp add sharedmemory -- npx -y @sharedmemory/mcp-server

Or with env vars:

bash
claude mcp add --env SHAREDMEMORY_API_KEY=sm_live_... \  --env SHAREDMEMORY_VOLUME_ID=your-volume-id \  sharedmemory -- npx -y @sharedmemory/mcp-server

Or create .mcp.json in your project root to share with your team:

json
{  "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/claude_desktop_config.json:

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:

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"      }    }  }}

VS Code Copilot

.vscode/mcp.json:

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:

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

VariableRequiredDefaultDescription
SHAREDMEMORY_API_KEYYes—Agent API key
SHAREDMEMORY_API_URLNohttps://api.sharedmemory.aiAPI endpoint
SHAREDMEMORY_VOLUME_IDNo—Default volume

Available tools

ToolDescription
rememberStore a fact or note
queryRetrieve context BEFORE answering — semantic search over memories
get_entityGet entity details and relationships
search_entitiesSearch entities by name
get_graphKnowledge graph overview
list_volumesList accessible volumes
delete_memoryDelete a memory by ID
update_memoryUpdate a memory by ID
feedbackSubmit feedback on memory relevance
batch_rememberStore multiple memories at once
get_memoryRetrieve a specific memory by ID
get_profileAuto-generated user profile from memories
get_contextGet a context block for LLM prompting
set_instructionStore a persistent rule all agents will follow
list_instructionsList all active instructions for a volume
list_documentsList uploaded documents

Resources

URIDescription
memory://graphKnowledge graph for the default volume

Prompts

NameDescription
summarize-knowledgeSummarize all knowledge in a volume
what-do-you-know-aboutRetrieve everything known about a topic

Documentation

https://docs.sharedmemory.ai/sdks/mcp-server

License

MIT

Source: README.md at commit 64a42ff

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v2.1.1LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Memory integrations

Memory.fit

fit.memoryOfficial publisher

Hosted Memory.fit server that lets an AI read your training, sleep, recovery and nutrition data and write back weekly plans, targets and meal plans.

Streamable HTTPWeb executableAuth
Location & LifestyleCredential requiredOct 29, 2026

pg.ddx.io: the PostgreSQL community's memory

io.ddx.pgOfficial publisher

pg.ddx.io: the PostgreSQL community's memory's hosted MCP server, published by pg.ddx.io; no sign-in required; Streamable HTTP; 29 tools.

Streamable HTTPWeb executable
Databases29 toolsOct 24, 2026

var.gg Naming Memory

gg.varOfficial publisher

Remote MCP server that suggests and searches code identifier names from domain concepts in Korean, Japanese, Chinese, Vietnamese and English, and exposes ERD…

Streamable HTTPWeb executable
Databases7 toolsOct 27, 2026

Counterparts

ai.counterparts

Local-first long-term memory for Claude Code and Claude Desktop: the assistant writes notes about you and your projects and recalls them in later sessions.

STDIODesktop only
AI & MLNot validated yetNov 7, 2026

LAHZE - Persian AI Memory Platform

Published by GitHub account pedramgholizadeh

LAHZE - Persian AI Memory Platform's hosted MCP server; no sign-in required; Streamable HTTP; 13 tools.

Streamable HTTPWeb executable
Location & Lifestyle13 toolsNov 3, 2026