Setup and Usage

Server URL

https://mcp.supermemory.ai/mcp

Add this to your MCP client config (Claude, Cursor, Windsurf, VS Code, etc.):

{
  "mcpServers": {
    "supermemory": {
      "url": "https://mcp.supermemory.ai/mcp"
    }
  }
}

The server requires OAuth authentication. Your MCP client will automatically discover the authorization server via /.well-known/oauth-protected-resource and prompt you to authenticate.

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

For a screenshot-backed walkthrough (Settings → Connectors → Add custom connector with the URL above), see Claude Desktop.

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.

Supermemory MCP

Plugins

Server URL

Project Scoping (Optional)

Client-Specific Setup

Claude Desktop

Cursor

Windsurf / VS Code

​Server URL

​Project Scoping (Optional)

​Client-Specific Setup

​Claude Desktop

​Cursor

​Windsurf / VS Code

Server URL

Project Scoping (Optional)

Client-Specific Setup

Claude Desktop

Cursor

Windsurf / VS Code