How do I install Memory?

Memory is a local plugin. Install it using npm package: @sharedmemory/mcp-server and add the generated configuration snippet to your AI app's MCP config file. Then restart your AI app.

What credentials does Memory need?

Memory requires the following credentials or environment variables: SHAREDMEMORY_API_KEY, SHAREDMEMORY_API_URL, SHAREDMEMORY_VOLUME_ID. You can find setup instructions on the server detail page.

What AI apps work with Memory?

Memory uses the Model Context Protocol (MCP) and works with any MCP-compatible AI app, including Claude, ChatGPT / Codex, Gemini, Copilot, Cursor, and more.

Back to Browse

Memory MCP Server

by Sharedmemoryai

Developer ToolsUse Caution4.8MCP RegistryLocal

Free

Server data from the Official MCP Registry

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

About

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

Security Report

4.8

Use Caution4.8High Risk

This is a well-structured MCP server for SharedMemory with proper authentication, secure credential handling, and appropriate scoping. The server requires API keys for operation, stores credentials in environment variables (not hardcoded), and makes authenticated API calls to a remote service. Minor code quality issues around error handling and input validation do not substantially impact security. Supply chain analysis found 3 known vulnerabilities in dependencies (0 critical, 3 high severity). Package verification found 1 issue.

4 files analyzed · 8 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

env_vars

Check that this permission is expected for this type of plugin.

HTTP Network Access

Connects to external APIs or services over the internet.

What You'll Need

Set these up before or after installing:

Your SharedMemory API keyRequired

Environment variable: SHAREDMEMORY_API_KEY

API endpoint URLOptional

Environment variable: SHAREDMEMORY_API_URL

Default volume/project IDOptional

Environment variable: SHAREDMEMORY_VOLUME_ID

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-sharedmemoryai-memory": {
      "env": {
        "SHAREDMEMORY_API_KEY": "your-sharedmemory-api-key-here",
        "SHAREDMEMORY_API_URL": "your-sharedmemory-api-url-here",
        "SHAREDMEMORY_VOLUME_ID": "your-sharedmemory-volume-id-here"
      },
      "args": [
        "-y",
        "@sharedmemory/mcp-server"
      ],
      "command": "npx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub 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:

# 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-server

Or with env vars:

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:

{
  "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:

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

Variable	Required	Default	Description
`SHAREDMEMORY_API_KEY`	Yes	—	Agent API key
`SHAREDMEMORY_API_URL`	No	`https://api.sharedmemory.ai`	API endpoint
`SHAREDMEMORY_VOLUME_ID`	No	—	Default volume

Available tools

Tool	Description
`remember`	Store a fact or note
`query`	Retrieve context BEFORE answering — semantic search over memories
`get_entity`	Get entity details and relationships
`search_entities`	Search entities by name
`get_graph`	Knowledge graph overview
`list_volumes`	List accessible volumes
`delete_memory`	Delete a memory by ID
`update_memory`	Update a memory by ID
`feedback`	Submit feedback on memory relevance
`batch_remember`	Store multiple memories at once
`get_memory`	Retrieve a specific memory by ID
`get_profile`	Auto-generated user profile from memories
`get_context`	Get a context block for LLM prompting
`set_instruction`	Store a persistent rule all agents will follow
`list_instructions`	List all active instructions for a volume
`list_documents`	List uploaded documents

Resources

URI	Description
`memory://graph`	Knowledge graph for the default volume

Prompts

Name	Description
`summarize-knowledge`	Summarize all knowledge in a volume
`what-do-you-know-about`	Retrieve everything known about a topic

Documentation

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

License

MIT

Reviews

No reviews yet

Be the first to review this server!

More Developer Tools MCP Servers

Git

Free

by Modelcontextprotocol · Developer Tools

Read, search, and manipulate Git repositories programmatically

Fetch

Free

by Modelcontextprotocol · Developer Tools

Web content fetching and conversion for efficient LLM usage

Toleno

Free

by Toleno · Developer Tools

Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.

Memory MCP Server

About

Security Report

Findings (8)Action required

Permissions Required

What You'll Need

How to Install

Documentation

@sharedmemory/mcp-server

Quick Install (Recommended)

Manual Setup

Claude Code

Claude Desktop

Cursor

VS Code Copilot

Windsurf

Configuration

Available tools

Resources

Prompts

Documentation

License

Reviews

No reviews yet

More Developer Tools MCP Servers

Git

Fetch

Toleno

mcp-creator-python

MarkItDown

FinAgent