diff --git a/apps/docs/docs.json b/apps/docs/docs.json
index 63c0af6b..9400ae9f 100644
--- a/apps/docs/docs.json
+++ b/apps/docs/docs.json
@@ -370,7 +370,10 @@
{
"group": "Setups",
"icon": "layers",
- "pages": ["supermemory-mcp/claude-desktop"]
+ "pages": [
+ "supermemory-mcp/chatgpt-web",
+ "supermemory-mcp/claude-desktop"
+ ]
}
]
},
diff --git a/apps/docs/images/supermemory-mcp/chatgpt-web/step-1-settings-dark.png b/apps/docs/images/supermemory-mcp/chatgpt-web/step-1-settings-dark.png
new file mode 100644
index 00000000..8cc7fac2
Binary files /dev/null and b/apps/docs/images/supermemory-mcp/chatgpt-web/step-1-settings-dark.png differ
diff --git a/apps/docs/images/supermemory-mcp/chatgpt-web/step-1-settings-light.png b/apps/docs/images/supermemory-mcp/chatgpt-web/step-1-settings-light.png
new file mode 100644
index 00000000..ff9e3757
Binary files /dev/null and b/apps/docs/images/supermemory-mcp/chatgpt-web/step-1-settings-light.png differ
diff --git a/apps/docs/images/supermemory-mcp/chatgpt-web/step-10-authorize.png b/apps/docs/images/supermemory-mcp/chatgpt-web/step-10-authorize.png
new file mode 100644
index 00000000..e5a64e10
Binary files /dev/null and b/apps/docs/images/supermemory-mcp/chatgpt-web/step-10-authorize.png differ
diff --git a/apps/docs/images/supermemory-mcp/chatgpt-web/step-11-connected-dark.png b/apps/docs/images/supermemory-mcp/chatgpt-web/step-11-connected-dark.png
new file mode 100644
index 00000000..e7df30a9
Binary files /dev/null and b/apps/docs/images/supermemory-mcp/chatgpt-web/step-11-connected-dark.png differ
diff --git a/apps/docs/images/supermemory-mcp/chatgpt-web/step-11-connected-light.png b/apps/docs/images/supermemory-mcp/chatgpt-web/step-11-connected-light.png
new file mode 100644
index 00000000..0acd5f3e
Binary files /dev/null and b/apps/docs/images/supermemory-mcp/chatgpt-web/step-11-connected-light.png differ
diff --git a/apps/docs/images/supermemory-mcp/chatgpt-web/step-2-plugins-dark.png b/apps/docs/images/supermemory-mcp/chatgpt-web/step-2-plugins-dark.png
new file mode 100644
index 00000000..8236307b
Binary files /dev/null and b/apps/docs/images/supermemory-mcp/chatgpt-web/step-2-plugins-dark.png differ
diff --git a/apps/docs/images/supermemory-mcp/chatgpt-web/step-2-plugins-light.png b/apps/docs/images/supermemory-mcp/chatgpt-web/step-2-plugins-light.png
new file mode 100644
index 00000000..6c86805e
Binary files /dev/null and b/apps/docs/images/supermemory-mcp/chatgpt-web/step-2-plugins-light.png differ
diff --git a/apps/docs/images/supermemory-mcp/chatgpt-web/step-3-plugins-bottom-dark.png b/apps/docs/images/supermemory-mcp/chatgpt-web/step-3-plugins-bottom-dark.png
new file mode 100644
index 00000000..9c789ac3
Binary files /dev/null and b/apps/docs/images/supermemory-mcp/chatgpt-web/step-3-plugins-bottom-dark.png differ
diff --git a/apps/docs/images/supermemory-mcp/chatgpt-web/step-3-plugins-bottom-light.png b/apps/docs/images/supermemory-mcp/chatgpt-web/step-3-plugins-bottom-light.png
new file mode 100644
index 00000000..8289db47
Binary files /dev/null and b/apps/docs/images/supermemory-mcp/chatgpt-web/step-3-plugins-bottom-light.png differ
diff --git a/apps/docs/images/supermemory-mcp/chatgpt-web/step-4-developer-mode-on-dark.png b/apps/docs/images/supermemory-mcp/chatgpt-web/step-4-developer-mode-on-dark.png
new file mode 100644
index 00000000..08b63d06
Binary files /dev/null and b/apps/docs/images/supermemory-mcp/chatgpt-web/step-4-developer-mode-on-dark.png differ
diff --git a/apps/docs/images/supermemory-mcp/chatgpt-web/step-4-developer-mode-on-light.png b/apps/docs/images/supermemory-mcp/chatgpt-web/step-4-developer-mode-on-light.png
new file mode 100644
index 00000000..e3d4df9d
Binary files /dev/null and b/apps/docs/images/supermemory-mcp/chatgpt-web/step-4-developer-mode-on-light.png differ
diff --git a/apps/docs/images/supermemory-mcp/chatgpt-web/step-4-developer-mode-page-dark.png b/apps/docs/images/supermemory-mcp/chatgpt-web/step-4-developer-mode-page-dark.png
new file mode 100644
index 00000000..df00d5a9
Binary files /dev/null and b/apps/docs/images/supermemory-mcp/chatgpt-web/step-4-developer-mode-page-dark.png differ
diff --git a/apps/docs/images/supermemory-mcp/chatgpt-web/step-4-developer-mode-page-light.png b/apps/docs/images/supermemory-mcp/chatgpt-web/step-4-developer-mode-page-light.png
new file mode 100644
index 00000000..a9c9aca8
Binary files /dev/null and b/apps/docs/images/supermemory-mcp/chatgpt-web/step-4-developer-mode-page-light.png differ
diff --git a/apps/docs/images/supermemory-mcp/chatgpt-web/step-6-plugin-directory-dark.png b/apps/docs/images/supermemory-mcp/chatgpt-web/step-6-plugin-directory-dark.png
new file mode 100644
index 00000000..09d073c3
Binary files /dev/null and b/apps/docs/images/supermemory-mcp/chatgpt-web/step-6-plugin-directory-dark.png differ
diff --git a/apps/docs/images/supermemory-mcp/chatgpt-web/step-6-plugin-directory-light.png b/apps/docs/images/supermemory-mcp/chatgpt-web/step-6-plugin-directory-light.png
new file mode 100644
index 00000000..9501417f
Binary files /dev/null and b/apps/docs/images/supermemory-mcp/chatgpt-web/step-6-plugin-directory-light.png differ
diff --git a/apps/docs/images/supermemory-mcp/chatgpt-web/step-7-details-dark.png b/apps/docs/images/supermemory-mcp/chatgpt-web/step-7-details-dark.png
new file mode 100644
index 00000000..ddd85916
Binary files /dev/null and b/apps/docs/images/supermemory-mcp/chatgpt-web/step-7-details-dark.png differ
diff --git a/apps/docs/images/supermemory-mcp/chatgpt-web/step-7-details-light.png b/apps/docs/images/supermemory-mcp/chatgpt-web/step-7-details-light.png
new file mode 100644
index 00000000..9faea445
Binary files /dev/null and b/apps/docs/images/supermemory-mcp/chatgpt-web/step-7-details-light.png differ
diff --git a/apps/docs/images/supermemory-mcp/chatgpt-web/step-8-confirm-dark.png b/apps/docs/images/supermemory-mcp/chatgpt-web/step-8-confirm-dark.png
new file mode 100644
index 00000000..324cf120
Binary files /dev/null and b/apps/docs/images/supermemory-mcp/chatgpt-web/step-8-confirm-dark.png differ
diff --git a/apps/docs/images/supermemory-mcp/chatgpt-web/step-8-confirm-light.png b/apps/docs/images/supermemory-mcp/chatgpt-web/step-8-confirm-light.png
new file mode 100644
index 00000000..cbd0f8ee
Binary files /dev/null and b/apps/docs/images/supermemory-mcp/chatgpt-web/step-8-confirm-light.png differ
diff --git a/apps/docs/images/supermemory-mcp/chatgpt-web/step-9-organization.png b/apps/docs/images/supermemory-mcp/chatgpt-web/step-9-organization.png
new file mode 100644
index 00000000..d6007d98
Binary files /dev/null and b/apps/docs/images/supermemory-mcp/chatgpt-web/step-9-organization.png differ
diff --git a/apps/docs/images/supermemory-mcp/chatgpt-web/step-9-sign-in-dark.png b/apps/docs/images/supermemory-mcp/chatgpt-web/step-9-sign-in-dark.png
new file mode 100644
index 00000000..262cb7f2
Binary files /dev/null and b/apps/docs/images/supermemory-mcp/chatgpt-web/step-9-sign-in-dark.png differ
diff --git a/apps/docs/images/supermemory-mcp/chatgpt-web/step-9-sign-in-light.png b/apps/docs/images/supermemory-mcp/chatgpt-web/step-9-sign-in-light.png
new file mode 100644
index 00000000..43a3ce78
Binary files /dev/null and b/apps/docs/images/supermemory-mcp/chatgpt-web/step-9-sign-in-light.png differ
diff --git a/apps/docs/images/supermemory-mcp/widgets/guided-save-dark.png b/apps/docs/images/supermemory-mcp/widgets/guided-save-dark.png
new file mode 100644
index 00000000..eca2a86b
Binary files /dev/null and b/apps/docs/images/supermemory-mcp/widgets/guided-save-dark.png differ
diff --git a/apps/docs/images/supermemory-mcp/widgets/guided-save-draft.png b/apps/docs/images/supermemory-mcp/widgets/guided-save-draft.png
new file mode 100644
index 00000000..3a252c76
Binary files /dev/null and b/apps/docs/images/supermemory-mcp/widgets/guided-save-draft.png differ
diff --git a/apps/docs/images/supermemory-mcp/widgets/memory-graph-dark.png b/apps/docs/images/supermemory-mcp/widgets/memory-graph-dark.png
new file mode 100644
index 00000000..cf37fe0b
Binary files /dev/null and b/apps/docs/images/supermemory-mcp/widgets/memory-graph-dark.png differ
diff --git a/apps/docs/images/supermemory-mcp/widgets/memory-graph.png b/apps/docs/images/supermemory-mcp/widgets/memory-graph.png
new file mode 100644
index 00000000..35aa7dcd
Binary files /dev/null and b/apps/docs/images/supermemory-mcp/widgets/memory-graph.png differ
diff --git a/apps/docs/images/supermemory-mcp/widgets/select-space-dark.png b/apps/docs/images/supermemory-mcp/widgets/select-space-dark.png
new file mode 100644
index 00000000..0087dbb4
Binary files /dev/null and b/apps/docs/images/supermemory-mcp/widgets/select-space-dark.png differ
diff --git a/apps/docs/images/supermemory-mcp/widgets/select-space.png b/apps/docs/images/supermemory-mcp/widgets/select-space.png
new file mode 100644
index 00000000..9958b7b8
Binary files /dev/null and b/apps/docs/images/supermemory-mcp/widgets/select-space.png differ
diff --git a/apps/docs/images/supermemory-mcp/widgets/upload-file-dark.png b/apps/docs/images/supermemory-mcp/widgets/upload-file-dark.png
new file mode 100644
index 00000000..4749ae04
Binary files /dev/null and b/apps/docs/images/supermemory-mcp/widgets/upload-file-dark.png differ
diff --git a/apps/docs/images/supermemory-mcp/widgets/upload-file.png b/apps/docs/images/supermemory-mcp/widgets/upload-file.png
new file mode 100644
index 00000000..55632912
Binary files /dev/null and b/apps/docs/images/supermemory-mcp/widgets/upload-file.png differ
diff --git a/apps/docs/supermemory-mcp/chatgpt-web.mdx b/apps/docs/supermemory-mcp/chatgpt-web.mdx
new file mode 100644
index 00000000..3fb29bc3
--- /dev/null
+++ b/apps/docs/supermemory-mcp/chatgpt-web.mdx
@@ -0,0 +1,199 @@
+---
+title: "ChatGPT Web"
+description: "Connect Supermemory MCP to ChatGPT Web through Plugins and OAuth"
+icon: "/images/openai.svg"
+sidebarTitle: "ChatGPT Web"
+---
+
+Connect Supermemory MCP to [ChatGPT Web](https://chatgpt.com) to use your Supermemory context directly in a conversation.
+
+## Step 1: Open Settings
+
+Open your profile menu in the lower-left corner of ChatGPT Web and select **Settings**.
+
+
+
+
+## Step 2: Open Plugins
+
+Select **Plugins** in the Settings sidebar.
+
+
+
+
+## Step 3: Open Developer mode
+
+Scroll to the bottom of **Plugins** and select **Developer mode**.
+
+
+
+
+## Step 4: Enable Developer mode
+
+ChatGPT opens the **Developer mode** section under **Security and login**. Turn **Developer mode** on.
+
+
+
+
+
+
+
+## Step 5: Open Browse plugins
+
+Return to **Plugins**, scroll to the bottom, and select **Browse plugins**.
+
+
+
+
+## Step 6: Add a plugin
+
+On the Plugins page, select the **plus icon** in the upper-right corner.
+
+
+
+
+## Step 7: Enter the Supermemory details
+
+Complete the **New Plugin** form:
+
+- In **Name**, enter `Supermemory MCP`.
+- In **Description**, enter `Memory/context for you ai agents`.
+- Under **Connection**, select **Server URL** instead of **Tunnel**.
+- In the URL field, paste `https://mcp.supermemory.ai/mcp`.
+
+The icon is optional. Leave **Advanced OAuth settings** unchanged.
+
+
+
+
+## Step 8: Confirm and create
+
+Scroll to the bottom of the form. Select **I understand and want to continue**, then select **Create**.
+
+
+
+
+## Step 9: Sign in to Supermemory
+
+ChatGPT opens the **Add Supermemory MCP to ChatGPT** dialog. Select **Sign in with Supermemory MCP**.
+
+
+
+
+
+ Accounts with access to more than one organization may see an organization picker. Select the organization you want ChatGPT Web to use.
+
+ 
+
+
+## Step 10: Approve access
+
+On the Supermemory authorization page:
+
+- Select **Read + Write** to let ChatGPT search and save Supermemory context. Select **Read only** if you only want search access.
+- Select **Full access** to use every available space, or **Scoped** to choose specific spaces.
+- Choose how long the connection should remain active.
+- Select **Approve**.
+
+
+
+## Step 11: Start using Supermemory
+
+After approval, ChatGPT returns to the Supermemory MCP plugin page. Select **Try in chat**.
+
+
+
+
+## Done
+
+Supermemory MCP is now ready to use in ChatGPT Web. You can manage or disconnect it later from the [Plugins page](https://chatgpt.com/plugins).
+
+**See also:** [MCP overview](/supermemory-mcp/mcp) | [Setup and Usage](/supermemory-mcp/setup) | [Claude Desktop](/supermemory-mcp/claude-desktop)
diff --git a/apps/docs/supermemory-mcp/claude-desktop.mdx b/apps/docs/supermemory-mcp/claude-desktop.mdx
index 802fb43f..8dbd8c7a 100644
--- a/apps/docs/supermemory-mcp/claude-desktop.mdx
+++ b/apps/docs/supermemory-mcp/claude-desktop.mdx
@@ -5,7 +5,7 @@ icon: "monitor"
sidebarTitle: "Claude Desktop"
---
-This guide walks through adding Supermemory as a **custom connector** in [Claude](https://claude.ai) (Desktop or web): open **Settings → Connectors**, add the MCP URL, connect, and authorize. For other clients and API-key auth, see [Setup and Usage](/supermemory-mcp/setup).
+This guide walks through adding Supermemory as a **custom connector** in [Claude](https://claude.ai) (Desktop or web): open **Settings → Connectors**, add the MCP URL, connect, and authorize. For other clients, see [Setup and Usage](/supermemory-mcp/setup).
## Step 1 — Open Connectors and add a custom connector
diff --git a/apps/docs/supermemory-mcp/mcp.mdx b/apps/docs/supermemory-mcp/mcp.mdx
index 867e8109..f38845af 100644
--- a/apps/docs/supermemory-mcp/mcp.mdx
+++ b/apps/docs/supermemory-mcp/mcp.mdx
@@ -1,55 +1,27 @@
---
title: "Overview"
-description: "Unified memory for Claude, Cursor, and every MCP client — one layer across all your tools"
+description: "Give every MCP-compatible assistant shared memory, team spaces, and interactive workflows"
icon: "brain-circuit"
---
-Most AI tools forget you the moment the tab closes. You re-explain preferences, restate project context, and re-teach the same lessons in Claude, Cursor, ChatGPT, and everything else.
+Supermemory MCP gives every MCP-compatible assistant a shared memory layer, so technical and non-technical teams can collaborate with AI using the same authorized context. Connect once to search decisions, save knowledge, upload source material, and explore relationships from the AI tools your team already uses.
-**Supermemory MCP** is a single memory layer that plugs into any MCP-compatible client. Connect once, and the same long-term memory follows you across tools — coding agents, chat apps, IDEs, and whatever you add next.
-
-## What you get
-
-- **Unified memory across tools** — Facts you save in Claude are available in Cursor (and vice versa). One brain, many surfaces.
-- **Memory that compounds** — Preferences, decisions, and project knowledge accumulate instead of resetting every session.
-- **Profiles that stay current** — Supermemory builds a living user profile from what you share, so assistants start with who you are — not a blank slate.
-- **Project-scoped context** — Keep work, personal, and client work separate with optional project tags.
-- **Works where you already work** — Claude (Connectors), Cursor, Windsurf, VS Code, Cline, and any client that speaks MCP.
-
-### Why a small tool surface is intentional
-
-Supermemory MCP exposes a **minimal** set of tools on purpose.
-
-Assistants don’t need a kitchen-sink API to remember well. They need a few durable actions: save what matters, recall what’s relevant, and know who the user is. Fewer tools means less confusion for the model, clearer behavior, and more reliable use in production.
-
-| Surface | Role |
-| --- | --- |
-| **`memory`** | Save or forget something durable |
-| **`recall`** | Search memories + optionally load the user profile |
-| **`whoAmI`** | Confirm the authenticated user / session |
-| **`context` prompt** | Inject a ready-to-use profile system message (`/context` in many clients) |
-| **Profile / projects resources** | Raw profile and project list for clients that read MCP resources |
-
-That’s enough for agents to build real continuity — without tool sprawl.
-
-## How it fits together
-
-1. You connect your client to `https://mcp.supermemory.ai/mcp` (OAuth).
-2. During conversations, the model stores important facts with **`memory`**.
-3. When context is needed, **`recall`** (and the profile) pull the right history back in.
-4. Switch tools tomorrow — same account, same memory.
-
-Under the hood, the server runs on **Cloudflare Workers** with Durable Objects for scalable, sticky sessions. Your data is isolated per account; open-source implementation is on GitHub.
+Engineering and research teams can carry project context across assistants, while finance, legal, medical, and operations teams can work from their own source material. Ask naturally. The assistant selects the right Supermemory tool without requiring code or tool names. See the [tools reference](#tools) for exact inputs and results.
## Connect
-Server URL:
+Add this remote MCP server to any compatible client:
```text
https://mcp.supermemory.ai/mcp
```
-Add it to your MCP client config:
+After you connect, your client opens Supermemory in a browser. Sign in or create an account, then choose which spaces the client can access. Supermemory uses OAuth, so no API key is required.
+
+For client-specific instructions, see [Setup and Usage](/supermemory-mcp/setup) or the [Claude Desktop guide](/supermemory-mcp/claude-desktop).
+
+
+MCP clients that use JSON configuration generally accept this shape:
```json
{
@@ -60,92 +32,142 @@ Add it to your MCP client config:
}
}
```
+
-The server requires **OAuth**. Your client will discover the authorization server via `/.well-known/oauth-protected-resource` and prompt you to authenticate.
+## How spaces work
-For Claude (Settings → Connectors), see **[Claude Desktop](/supermemory-mcp/claude-desktop)**. For client-specific examples, see **[Setup and Usage](/supermemory-mcp/setup)**.
+A **space** keeps a team's documents, memories, and profile context focused, so AI retrieves the right knowledge without mixing unrelated work. Use separate spaces for an engineering launch, research project, finance workflow, legal matter, medical knowledge base, or any other shared initiative. Teammates collaborate within the spaces they are allowed to read or write.
-### Project Scoping
-
-Scope all operations to a specific project with `x-sm-project`:
-
-```json
-{
- "mcpServers": {
- "supermemory": {
- "url": "https://mcp.supermemory.ai/mcp",
- "headers": {
- "x-sm-project": "your-project-id"
- }
- }
- }
-}
-```
+Name a space to use it for one request without changing your active space. Otherwise, Supermemory uses your active space or account default. Ask to switch spaces when you want future requests to use a different active space.
## Tools
-### `memory`
+Your assistant chooses these tools automatically. Use this table when you need the exact inputs and results.
-Save or forget information about the user.
+| Tool | Use it for | Inputs | Result |
+| --- | --- | --- | --- |
+| `search_memory` | Semantic recall from one space, with optional profile context | `query` (required), `includeProfile`, `containerTag` | Profile context and matching memories |
+| `add_memory` | Save information or forget outdated information | `content` (required), `action` (`save` or `forget`), `containerTag` | Save or forget confirmation |
+| `listDocuments` | Browse stored source documents and their summaries | `page`, `limit`, `containerTag` | Document IDs, titles, types, status, dates, and summaries |
+| `getDocument` | Read the available content of one document | `documentId` (required) | Document metadata, summary, and available content |
+| `listMemories` | Browse recent extracted memory entries and their source document IDs | `page`, `limit`, `containerTag` | Memory IDs, text, versions, and source document IDs |
+| `listSpaces` | List accessible spaces and resolve a space name to its key | None | Formatted list plus structured `spaces` and `count` fields |
+| `whoAmI` | Inspect the authenticated account, permissions, scope, and active space | None | Account and access context |
-| Parameter | Type | Required | Description |
-|-----------|------|----------|-------------|
-| `content` | string | Yes | The memory content to save or forget |
-| `action` | `"save"` \| `"forget"` | No | Default: `"save"` |
-| `containerTag` | string | No | Project tag to scope the memory |
+### Search
-### `recall`
+`search_memory` accepts a natural-language query and returns semantically relevant memories. By default, it also includes stable and recent profile context from the same space. Set `includeProfile` to `false` when only matching memories are needed.
-Search memories and get user profile.
+Use the retrieval tools for different questions:
-| Parameter | Type | Required | Description |
-|-----------|------|----------|-------------|
-| `query` | string | Yes | Search query to find relevant memories |
-| `includeProfile` | boolean | No | Include user profile summary. Default: `true` |
-| `containerTag` | string | No | Project tag to scope the search |
+- Use `search_memory` to answer a question from remembered context.
+- Use `listDocuments` to discover stored sources, then `getDocument` to read one source in full.
+- Use `listMemories` to inspect the extracted memory entries themselves, including their IDs and source document IDs.
-### `whoAmI`
+`listDocuments` and `listMemories` default to 10 results per page and accept up to 50.
-Get the current logged-in user's information. Returns `{ userId, email, name, client, sessionId }`.
+### Save or forget
-## Resources
+`add_memory` saves the supplied `content` by default. Set `action` to `forget` when a fact is outdated or should be removed. There is no separate forget tool.
-| URI | Description |
-|-----|-------------|
-| `supermemory://profile` | User profile with stable preferences and recent activity |
-| `supermemory://projects` | List of available memory projects |
+If the content is already final, the assistant should use `add_memory`. If you want to review, edit, or choose a space before saving, it should open the `guided-save` widget instead.
-## Prompts
+### Access control
-### `context`
+`whoAmI` returns the current identity, role, access type, granted scope, and active space. `listSpaces` returns only spaces the authenticated account can access, with names, keys, document and memory counts, and recent activity.
-Inject user profile and preferences as system context for AI conversations. Returns a formatted message with the user's stable preferences and recent activity.
+## Interactive widgets
-In Cursor and Claude Code you can often invoke this with **`/context`**, which gives the model enough profile context to use and query Supermemory effectively.
+Clients that support [MCP Apps](https://modelcontextprotocol.io/extensions/apps/overview) can open these Supermemory widgets directly inside the conversation.
-**Purpose:** Unlike the `recall` tool (search for specific information) or the `profile` resource (raw data), the `context` prompt is a pre-formatted system message for conversation start.
+| Tool | What it opens |
+| --- | --- |
+| `select-space` | A searchable space picker |
+| `guided-save` | An editable memory form with a space selector |
+| `upload-file` | A local file picker and upload form |
+| `memory-graph` | An interactive graph of documents and memories |
-| Parameter | Type | Required | Description |
-|-----------|------|----------|-------------|
-| `containerTag` | string | No | Project tag to scope the profile (max 128 chars) |
-| `includeRecent` | boolean | No | Include recent activity in the profile. Default: `true` |
+### Select a space
-**Output format:**
-- Instructions to save new memories using the `memory` tool
-- **Stable Preferences:** Long-term user facts and preferences
-- **Recent Activity:** Recent interactions and context (when `includeRecent` is `true`)
-- Fallback message when no profile exists yet
+`select-space` opens a searchable space picker and changes the active space for future Supermemory actions. A one-off request in another space does not change the active space.
-**When to use:**
-- **`context` prompt** — automatic system context at conversation start
-- **`recall` tool** — search for specific information
-- **`profile` resource** — raw profile data for custom processing
+
+
+
+### Guided save
+
+`guided-save` opens a draft with editable memory content and a writable-space selector. The assistant can prefill the draft, but nothing is saved until you submit it.
+
+
+
+
+### File upload
+
+`upload-file` opens a local file picker and uploads one file at a time to a writable space.
+
+Supported types include text, Markdown, PDF, Word, CSV, common images, MP3, WAV, M4A, MP4, and WebM.
+
+
+
+
+### Memory graph
+
+`memory-graph` renders the selected space as an interactive graph of source documents and extracted memories.
+
+When no space is named, the server automatically uses the active space or account default. If you name a specific space, the assistant calls `listSpaces` to resolve its name to a space key, then opens that space's graph.
+
+
+
+
+## Resources and context prompt
+
+Some MCP clients also expose resources and prompts:
+
+| Kind | Name or URI | What it returns |
+| --- | --- | --- |
+| Resource | `supermemory://profile` | Stable and recent profile context for the active space |
+| Resource | `supermemory://spaces` | A compact list of accessible spaces with the active space marked |
+| Prompt | `context` | A ready-to-attach context message for the active space, plus up to three recently active spaces |
+
+The `context` prompt takes no arguments. It returns profile context for the active space and up to three recently active spaces.
- Client configs, OAuth, and project scoping.
+ Configure Supermemory in supported MCP clients.
-
- Open-source implementation.
+
+ View the source code.
diff --git a/apps/docs/supermemory-mcp/setup.mdx b/apps/docs/supermemory-mcp/setup.mdx
index fec15ab1..0110e58d 100644
--- a/apps/docs/supermemory-mcp/setup.mdx
+++ b/apps/docs/supermemory-mcp/setup.mdx
@@ -1,7 +1,7 @@
---
-title: 'Setup and Usage'
-description: 'How to set up and use Supermemory MCP Server 4.0'
-icon: 'settings'
+title: "Setup and Usage"
+description: "Connect Supermemory to an MCP client with OAuth and choose how requests use spaces"
+icon: "settings"
---
## Server URL
@@ -10,7 +10,7 @@ icon: 'settings'
https://mcp.supermemory.ai/mcp
```
-Add this to your MCP client config (Claude, Cursor, Windsurf, VS Code, etc.):
+Add the remote server to your MCP client:
```json
{
@@ -22,36 +22,30 @@ Add this to your MCP client config (Claude, Cursor, Windsurf, VS Code, etc.):
}
```
-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.
+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.
-## Project Scoping (Optional)
+## Choose a space
-To scope all operations to a specific project, add the `x-sm-project` header:
+After connecting, space-aware tools use your active Supermemory space or account default. You can work in another space in two ways:
-```json
-{
- "mcpServers": {
- "supermemory": {
- "url": "https://mcp.supermemory.ai/mcp",
- "headers": {
- "x-sm-project": "your-project-id"
- }
- }
- }
-}
-```
+- Name a space for a one-off action without changing your active space.
+- Ask to switch your active space for future actions.
-This keeps memories organized by project, useful when working on multiple codebases or contexts.
+See [How spaces work](/supermemory-mcp/mcp#how-spaces-work) for examples and routing rules.
-## Client-Specific Setup
+## Client-specific setup
-### Claude Desktop
+### ChatGPT Web
-For a screenshot-backed walkthrough (Settings → Connectors → Add custom connector with the URL above), see **[Claude Desktop](/supermemory-mcp/claude-desktop)**.
+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 to `~/.cursor/mcp.json`:
+Add the server to `~/.cursor/mcp.json`:
```json
{
@@ -63,8 +57,22 @@ Add to `~/.cursor/mcp.json`:
}
```
-Or use the one-click install button at [app.supermemory.ai](https://app.supermemory.ai).
+You can also use the install option in [app.supermemory.ai](https://app.supermemory.ai).
-### Windsurf / VS Code
+### Other MCP clients
-Configuration varies by extension. Generally, add the server URL (`https://mcp.supermemory.ai/mcp`) to your MCP settings.
+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.