# SharedMemory MCP server

> Provides AI agents with persistent memory and a shared knowledge graph to remember, recall, and explore information.

- Repository: https://github.com/sharedmemoryai/mcp-server
- Page: https://hostedmcp.org/servers/sharedmemoryai/mcp-server
- Transport: stdio
- Stars: 1
- License: MIT
- Latest version: 2.1.1

## Install

### Claude Code

```sh
claude mcp add --env SHAREDMEMORY_API_KEY=<YOUR_SHAREDMEMORY_API_KEY> mcp-server -- npx -y @sharedmemory/mcp-server
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@sharedmemory/mcp-server"
      ],
      "env": {
        "SHAREDMEMORY_API_KEY": "<YOUR_SHAREDMEMORY_API_KEY>"
      }
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@sharedmemory/mcp-server"
      ],
      "env": {
        "SHAREDMEMORY_API_KEY": "<YOUR_SHAREDMEMORY_API_KEY>"
      }
    }
  }
}
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@sharedmemory/mcp-server"
      ],
      "env": {
        "SHAREDMEMORY_API_KEY": "<YOUR_SHAREDMEMORY_API_KEY>"
      }
    }
  }
}
```

### Codex (`~/.codex/config.toml`)

```toml
[mcp_servers.mcp-server]
command = "npx"
args = ["-y", "@sharedmemory/mcp-server"]

[mcp_servers.mcp-server.env]
SHAREDMEMORY_API_KEY = "<YOUR_SHAREDMEMORY_API_KEY>"
```

### Gemini CLI (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@sharedmemory/mcp-server"
      ],
      "env": {
        "SHAREDMEMORY_API_KEY": "<YOUR_SHAREDMEMORY_API_KEY>"
      }
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `SHAREDMEMORY_API_KEY` | yes | yes | Your SharedMemory API key |
| `SHAREDMEMORY_API_URL` | no | no | API endpoint URL |
| `SHAREDMEMORY_VOLUME_ID` | no | no | Default volume/project ID |

## Tools (16)

- `remember`
- `query`
- `get_entity`
- `search_entities`
- `get_graph`
- `list_volumes`
- `delete_memory`
- `update_memory`
- `feedback`
- `batch_remember`
- `get_memory`
- `get_profile`
- `get_context`
- `set_instruction`
- `list_instructions`
- `list_documents`

## FAQ

### Which AI clients are supported?

The server supports Claude Code, Claude Desktop, Cursor, VS Code Copilot, and Windsurf.