Skip to content
Supermemory Help Center
InboxAsk a human

Connecting Supermemory to Claude, ChatGPT, Cursor, and other tools

Two ways to connect

Supermemory connects to your AI tools in one of two ways, depending on the tool:

  • The Supermemory MCP server — for chat assistants such as Claude, ChatGPT, and Cursor. One remote server URL, authenticated with OAuth. This is the usual path.
  • A dedicated plugin — for coding agents such as Claude Code, OpenAI Codex CLI, and OpenCode. These install hooks and skills so memory is recalled and saved automatically during a session.

The MCP server

The Supermemory MCP server URL is:

https://mcp.supermemory.ai/mcp

Authentication is OAuth — no API key or custom header is required. When you connect, your client opens Supermemory in a browser so you can sign in and choose which spaces the client may access. During authorization you pick the access level (read + write, or read only), whether the client gets full or scoped space access, and an expiration.

Most MCP clients that use JSON config accept this shape:

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

Claude Desktop and Claude web

  1. Open Settings > Connectors and choose Add custom connector.
  2. Set the name to Supermemory and the remote MCP server URL to https://mcp.supermemory.ai/mcp. Leave the OAuth fields empty unless you have custom credentials, then click Add.
  3. Find Supermemory in your connectors list and click Connect.
  4. On the Supermemory authorization page, select the scopes you want and click Authorize.

You can change or revoke permissions later from Settings > Connectors.

ChatGPT (web)

  1. Open Settings from your profile menu, then go to Plugins.
  2. Scroll to the bottom of the Plugins section and enable Developer mode under "Security and login".
  3. Back in Plugins, choose Browse plugins, then the plus icon to add one.
  4. Set the name to Supermemory MCP, the connection type to Server URL, and the URL to https://mcp.supermemory.ai/mcp.
  5. Confirm the acknowledgment to create the plugin, then choose Sign in with Supermemory MCP and approve the access level, space scope, and expiration.

To make Supermemory your default memory in ChatGPT, turn off ChatGPT's built-in memory and add a custom instruction such as "Use Supermemory MCP as my default memory and workspace."

Cursor

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

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

You can also use the install option in app.supermemory.ai.

Other MCP clients

Any client that supports remote MCP servers works the same way: add https://mcp.supermemory.ai/mcp as a remote HTTP MCP server, then complete the OAuth flow your client opens. Menu names and config file locations vary between clients — check your client's own MCP documentation for where its server list lives. If a client only supports local (stdio) servers, you will need a remote-MCP proxy; consult that client's documentation.

Clients with MCP Apps support also render Supermemory's interactive widgets inline: a space picker, a guided save form, a file upload picker, and the memory graph.

Coding agents (Claude Code, Codex, OpenCode)

These use plugins rather than the MCP server, and they authenticate with an API key or browser login rather than the MCP OAuth flow.

Claude Code — run these in Claude Code (Node.js 18+ must be on your PATH):

/plugin marketplace add supermemoryai/claude-supermemory
/plugin install supermemory

Then set SUPERMEMORY_CC_API_KEY in your shell profile using a key from the console. Useful commands: /supermemory:status, /supermemory:index, /supermemory:logout.

OpenAI Codex CLI — npx codex-supermemory@latest install, then restart Codex. On your first prompt a browser opens to authenticate; you can also run /supermemory-login or set SUPERMEMORY_CODEX_API_KEY. Verify with npx codex-supermemory status.

OpenCode — bunx opencode-supermemory@latest install, then bunx opencode-supermemory@latest login. Verify with bunx opencode-supermemory@latest status.

Plugins for OpenClaw and Hermes are documented too. See the Integrations section of the docs for the current list and per-tool details.

Do all my tools share the same memories?

Yes — memory lives in your Supermemory account, not in any one client. Every tool you authorize reads and writes the same underlying spaces, so something saved from Claude is retrievable from ChatGPT or Cursor.

What each tool sees is controlled by two things: the scopes you granted it during authorization, and the space it is working in. Space-aware tools use your active space (or your account default) unless you name a different space for a single request. You can ask your assistant to switch your active space for future requests, or use the space picker widget if your client supports it.

Check that it worked

After connecting, try one of these in your assistant:

  • "What Supermemory spaces can I access?"
  • "What is my active Supermemory space?"
  • "Search my saved context for the launch plan."
  • "Show my memory graph."

If the connection fails

If a client will not connect or authorize, see the “Troubleshooting MCP connections” article in this help center, or contact support with the client name and the error you see. If you are looking for a browser extension or a client not listed above, contact support — we will point you at the current option rather than guess.