---
title: "Setup and Usage"
description: "Connect Supermemory to an MCP client with OAuth and choose how requests use spaces"
icon: "settings"
---

## Server URL

```text
https://mcp.supermemory.ai/mcp
```

Add the remote server to your MCP client:

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

Supermemory MCP uses OAuth. Your client opens the authorization page so you can sign in and approve access. No API key or custom header is required.

## Choose a space

After connecting, space-aware tools use your active Supermemory space or account default. You can work in another space in two ways:

- Name a space for a one-off action without changing your active space.
- Ask to switch your active space for future actions.

See [How spaces work](/supermemory-mcp/mcp#how-spaces-work) for examples and routing rules.

## Client-specific setup

### ChatGPT Web

Enable developer mode, add Supermemory from the ChatGPT Plugins page, and complete OAuth. See the [ChatGPT Web guide](/supermemory-mcp/chatgpt-web) for the complete flow.

### Claude Desktop and Claude web

Open **Settings > Connectors**, add a custom connector, and enter the server URL. See the [Claude Desktop guide](/supermemory-mcp/claude-desktop) for the complete flow.

### Cursor

Add the server to `~/.cursor/mcp.json`:

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

You can also use the install option in [app.supermemory.ai](https://app.supermemory.ai).

### Other MCP clients

Add `https://mcp.supermemory.ai/mcp` as a remote HTTP MCP server and complete the OAuth flow opened by your client. Exact menu names and configuration locations vary between clients.

Clients with MCP Apps support render the space picker, guided save, file upload, and memory graph directly in the conversation.

## Verify the connection

Start with any of these requests:

- "What Supermemory spaces can I access?"
- "What is my active Supermemory space?"
- "Search my saved context for the launch plan."
- "I want to upload a file to Supermemory."
- "Show my memory graph."

The [MCP overview](/supermemory-mcp/mcp) documents every tool, widget, resource, and the `context` prompt.
