Setup and Usage

How to set up and use Supermemory MCP Server 4.0

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 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

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.