{
  "markdown": "# @sharedmemory/mcp-server\n\n[Model Context Protocol](https://modelcontextprotocol.io) server for [SharedMemory](https://sharedmemory.ai). Gives Claude Code, Claude Desktop, Cursor, VS Code Copilot, and other MCP-compatible tools persistent memory.\n\n## Quick Install (Recommended)\n\nThe fastest way to set up SharedMemory — one command, no JSON editing:\n\n```bash\n# Interactive — picks your client, asks for your API key\nnpx -y @sharedmemory/mcp-server install\n\n# Or specify everything inline\nnpx -y @sharedmemory/mcp-server install --cursor --api-key sm_live_... --volume your-volume-id\n\n# Install for all supported clients at once\nnpx -y @sharedmemory/mcp-server install --all --api-key sm_live_...\n```\n\nSupported clients: `--claude-code`, `--claude`, `--cursor`, `--vscode`, `--windsurf`, `--all`\n\n## Manual Setup\n\nIf you prefer to edit config files yourself:\n\n### Claude Code\n\nOne command:\n\n```bash\nclaude mcp add sharedmemory -- npx -y @sharedmemory/mcp-server\n```\n\nOr with env vars:\n\n```bash\nclaude mcp add --env SHAREDMEMORY_API_KEY=sm_live_... \\\n  --env SHAREDMEMORY_VOLUME_ID=your-volume-id \\\n  sharedmemory -- npx -y @sharedmemory/mcp-server\n```\n\nOr create `.mcp.json` in your project root to share with your team:\n\n```json\n{\n  \"mcpServers\": {\n    \"sharedmemory\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@sharedmemory/mcp-server\"],\n      \"env\": {\n        \"SHAREDMEMORY_API_KEY\": \"${SHAREDMEMORY_API_KEY}\",\n        \"SHAREDMEMORY_API_URL\": \"https://api.sharedmemory.ai\",\n        \"SHAREDMEMORY_VOLUME_ID\": \"${SHAREDMEMORY_VOLUME_ID}\"\n      }\n    }\n  }\n}\n```\n\n> **Tip:** Copy the included [`CLAUDE.md`](./CLAUDE.md) into your project root to teach Claude Code when and how to use SharedMemory proactively.\n\n### Claude Desktop\n\n`~/Library/Application Support/Claude/claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"sharedmemory\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@sharedmemory/mcp-server\"],\n      \"env\": {\n        \"SHAREDMEMORY_API_KEY\": \"sm_live_...\",\n        \"SHAREDMEMORY_API_URL\": \"https://api.sharedmemory.ai\",\n        \"SHAREDMEMORY_VOLUME_ID\": \"your-volume-id\"\n      }\n    }\n  }\n}\n```\n\n### Cursor\n\n`.cursor/mcp.json` in your project root:\n\n```json\n{\n  \"mcpServers\": {\n    \"sharedmemory\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@sharedmemory/mcp-server\"],\n      \"env\": {\n        \"SHAREDMEMORY_API_KEY\": \"sm_live_...\",\n        \"SHAREDMEMORY_API_URL\": \"https://api.sharedmemory.ai\",\n        \"SHAREDMEMORY_VOLUME_ID\": \"your-volume-id\"\n      }\n    }\n  }\n}\n```\n\n### VS Code Copilot\n\n`.vscode/mcp.json`:\n\n```json\n{\n  \"servers\": {\n    \"sharedmemory\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@sharedmemory/mcp-server\"],\n      \"env\": {\n        \"SHAREDMEMORY_API_KEY\": \"sm_live_...\",\n        \"SHAREDMEMORY_API_URL\": \"https://api.sharedmemory.ai\",\n        \"SHAREDMEMORY_VOLUME_ID\": \"your-volume-id\"\n      }\n    }\n  }\n}\n```\n\n### Windsurf\n\n`~/.codeium/windsurf/mcp_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"sharedmemory\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@sharedmemory/mcp-server\"],\n      \"env\": {\n        \"SHAREDMEMORY_API_KEY\": \"sm_live_...\",\n        \"SHAREDMEMORY_API_URL\": \"https://api.sharedmemory.ai\",\n        \"SHAREDMEMORY_VOLUME_ID\": \"your-volume-id\"\n      }\n    }\n  }\n}\n```\n\n## Configuration\n\n| Variable | Required | Default | Description |\n|----------|----------|---------|-------------|\n| `SHAREDMEMORY_API_KEY` | Yes | — | Agent API key |\n| `SHAREDMEMORY_API_URL` | No | `https://api.sharedmemory.ai` | API endpoint |\n| `SHAREDMEMORY_VOLUME_ID` | No | — | Default volume |\n\n## Available tools\n\n| Tool | Description |\n|------|-------------|\n| `remember` | Store a fact or note |\n| `query` | Retrieve context BEFORE answering — semantic search over memories |\n| `get_entity` | Get entity details and relationships |\n| `search_entities` | Search entities by name |\n| `get_graph` | Knowledge graph overview |\n| `list_volumes` | List accessible volumes |\n| `delete_memory` | Delete a memory by ID |\n| `update_memory` | Update a memory by ID |\n| `feedback` | Submit feedback on memory relevance |\n| `batch_remember` | Store multiple memories at once |\n| `get_memory` | Retrieve a specific memory by ID |\n| `get_profile` | Auto-generated user profile from memories |\n| `get_context` | Get a context block for LLM prompting |\n| `set_instruction` | Store a persistent rule all agents will follow |\n| `list_instructions` | List all active instructions for a volume |\n| `list_documents` | List uploaded documents |\n\n## Resources\n\n| URI | Description |\n|-----|-------------|\n| `memory://graph` | Knowledge graph for the default volume |\n\n## Prompts\n\n| Name | Description |\n|------|-------------|\n| `summarize-knowledge` | Summarize all knowledge in a volume |\n| `what-do-you-know-about` | Retrieve everything known about a topic |\n\n## Documentation\n\nhttps://docs.sharedmemory.ai/sdks/mcp-server\n\n## License\n\nMIT\n",
  "bytes": 4881,
  "sha": "943cd1b359aa063d3fd69f2f4606c8905b42e646f3a53bb843b7e076a7f79735",
  "repo_slug": "sharedmemoryai/mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_sharedmemoryai_memory_b200a4a0/readme"
}