{
  "id": "page:docs-supermemory-research-raw-07-mcp-server",
  "_kind": "Page",
  "_file": "wiki/docs/supermemory-research/raw/07-mcp-server.md",
  "_cluster": "wiki",
  "attributes": {
    "nodeKind": "Page",
    "sourcePath": "docs/supermemory-research/raw/07-mcp-server.md",
    "sourceKind": "repo-docs",
    "title": "Supermemory MCP Server",
    "displayName": "Supermemory MCP Server",
    "slug": "docs/supermemory-research/raw/07-mcp-server",
    "articlePath": "wiki/docs/supermemory-research/raw/07-mcp-server.md",
    "article": "\n# Supermemory MCP Server\n\nSources: https://supermemory.ai/docs/supermemory-mcp/introduction, https://supermemory.ai/docs/supermemory-mcp/setup, https://github.com/supermemoryai/supermemory/tree/main/apps/mcp\n\n## Overview\n\nSupermemory MCP Server 4.0 provides AI assistants with persistent memory across conversations through the Model Context Protocol. Built on Cloudflare Workers with Durable Objects for scalable, persistent connections.\n\n## Core Tools\n\nThe MCP server exposes these tools:\n\n1. **addMemory** -- Save information about the user with optional project scoping\n2. **search** -- Search memories and get user profile with flexible queries\n3. **getProjects** -- List available projects\n4. **whoAmI** -- Returns authenticated user details (userId, email, session info)\n\n## Authentication\n\n### OAuth (Primary)\n\nAutomatic discovery via `/.well-known/oauth-protected-resource`. The MCP client handles authorization and prompts for login automatically.\n\n### API Key (Alternative)\n\nBearer tokens prefixed with `sm_` passed through Authorization headers. Get keys from app.supermemory.ai.\n\n## Installation\n\n### Quick Install\n\n```bash\nnpx -y install-mcp@latest https://mcp.supermemory.ai/mcp --client claude --oauth=yes\n```\n\nSubstitute client name (cursor, windsurf, vscode, etc.) for \"claude\".\n\n### Manual Configuration\n\nAdd the server URL `https://mcp.supermemory.ai/mcp` to your MCP client's configuration file.\n\n## Project Scoping\n\nAdd `x-sm-project` header to scope all operations to a specific project, keeping memories organized by project.\n\n## Supported Clients\n\n- Claude Desktop\n- Cursor IDE\n- Windsurf\n- VS Code with AI extensions\n- Cline/Roo-Cline\n- Claude Code\n- OpenCode\n- OpenClaw\n- Hermes\n\n## Technical Architecture\n\n- Cloudflare Workers infrastructure\n- Durable Objects for persistent session state\n- SQLite for data persistence\n- Hono framework for request handling\n- PostHog integration for analytics\n\n## Security\n\nComplete user data separation per account. Open-source code for transparency.\n",
    "documents": []
  },
  "outgoingEdges": [],
  "incomingEdges": [
    {
      "from": "page:docs-supermemory-research",
      "to": "page:docs-supermemory-research-raw-07-mcp-server",
      "kind": "contains_page"
    }
  ]
}