Skip to main content
npx -y install-mcp@latest https://mcp.supermemory.ai/mcp --client claude --oauth=yes
Replace claude with your MCP client: cursor, windsurf, vscode, etc.

​
Manual Configuration

Add this to your MCP client config (Claude Desktop, Cursor, Windsurf, etc.): 
{
  "mcpServers": {
    "supermemory": {
      "url": "https://mcp.supermemory.ai/mcp"
    }
  }
}
The server uses OAuth authentication by default. Your MCP client will automatically discover the authorization server via /.well-known/oauth-protected-resource and prompt you to authenticate.

​
API Key Authentication (Alternative)

If you prefer to use an API key instead of OAuth, get one from app.supermemory.ai and pass it in the Authorization header: 
{
  "mcpServers": {
    "supermemory": {
      "url": "https://mcp.supermemory.ai/mcp",
      "headers": {
        "Authorization": "Bearer sm_your_api_key_here"
      }
    }
  }
}
API keys start with sm_ and are automatically detected. When an API key is provided, OAuth authentication is skipped.

​
Project Scoping (Optional)

To scope all operations to a specific project, add the x-sm-project header: 
{
  "mcpServers": {
    "supermemory": {
      "url": "https://mcp.supermemory.ai/mcp",
      "headers": {
        "x-sm-project": "your-project-id"
      }
    }
  }
}
This keeps memories organized by project, useful when working on multiple codebases or contexts.

​
Client-Specific Setup

​
Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows): 
{
  "mcpServers": {
    "supermemory": {
      "url": "https://mcp.supermemory.ai/mcp"
    }
  }
}

​
Cursor

Add to ~/.cursor/mcp.json: 
{
  "mcpServers": {
    "supermemory": {
      "url": "https://mcp.supermemory.ai/mcp"
    }
  }
}
Or use the one-click install button at app.supermemory.ai.

​
Windsurf / VS Code

Configuration varies by extension. Generally, add the server URL (https://mcp.supermemory.ai/mcp) to your MCP settings.