# Supermemory

<div style={{maxWidth: '720px'}}>
![The Supermemory connector in Workspace Settings, for saving and recalling memories across sessions, with a Connect button](</docs/_next/static/media/supermemory-connector.10u0y-b-vnw3-.jpg>)
</div>

The [Supermemory MCP server](https://supermemory.ai/docs/supermemory-mcp/mcp) lets agents save what they learn and recall it in later tickets and chats, so context such as team conventions, past decisions, and customer preferences carries across sessions.

For use cases and example prompts, see [Supermemory for AI coding agents](/integrations/supermemory).

## What is Supermemory? [#what-is-supermemory]

[Supermemory](https://supermemory.ai) is a memory layer for AI tools. It stores memories and documents in spaces, and makes them searchable from any AI tool connected to your account.

## What agents can do [#what-agents-can-do]

Once you connect Supermemory, agents can:

- Save facts, decisions, and preferences as memories, or forget ones that are out of date
- Search and recall memories from earlier sessions
- Browse the documents and spaces in your Supermemory account
- Share the same memories with the other AI tools you connect to Supermemory

Anyone whose agents can use the connection can read and add memories in that Supermemory account.

## Setup [#setup]

Go to **Workspace Settings → Connectors** (or a project's **Connectors** page). Click **Add**, search for Supermemory, and select it. You can also click **Connect** on the Supermemory card, or **Connect another** to add another account.

### Step 1: who the connection is for [#step-1-who-the-connection-is-for]

Choose **Me** or **Workspace** as the owner, then choose which agents can use the connection. The default is **Me**, with **My personal assistants** selected. From a project's **Connectors** page, only **In this project** is selected instead. Enable **Team assistants** or **Agents in projects** separately. Anyone in the workspace can use the connection through the team assistants you pick, and anyone with access to the projects you pick can use it, including in sessions they launch themselves. See [connection options](/docs/integrations/connectors#fill-in-the-connection-details) for what each choice means.

Click **Continue**.

### Step 2: how agents reach Supermemory [#step-2-how-agents-reach-supermemory]

The second screen has two tabs: **Supermemory account** and **Access token**. Pick one.

#### Supermemory account [#supermemory-account]

This tab is selected by default, and there's no key to create.

Click **Continue to Supermemory**. Supermemory asks you to sign in and approve access. Approve, and you land back on the Connectors page with **Supermemory connected**.

Agents then read and write memories as whoever signed in. If you enable **In projects**, anyone with access to those projects can use that account's memories — so sign in with an account meant for team memories.

#### Access token [#access-token]

Use this tab if you'd rather paste a key than sign in. In the [Supermemory developer console](https://console.supermemory.ai/keys), go to **API Keys → Create API Key**. Keys start with `sm_`. Paste it into the **Supermemory API Key** field and click **Connect Supermemory**.

## Reconnecting and disconnecting [#reconnecting-and-disconnecting]

If an account connection stops working, the Connectors page shows a **Reconnect needed** badge on it, and agents run without Supermemory.

To fix it, click **Manage** next to the connection, then **Reconnect Supermemory**, and sign in again. You can only reconnect a personal connection you own; for someone else's, Superconductor tells you who to ask.

A pasted access token that Supermemory stops accepting doesn't show **Reconnect needed**. Agents' Supermemory calls fail until you paste a new token under **Manage** and click its **Save** button.

**Disconnect** also revokes Superconductor's access at Supermemory. If Supermemory doesn't confirm the revocation, Superconductor tells you to remove Superconductor from your Supermemory account to finish the job.

## When to use it [#when-to-use-it]

Ask agents to use Supermemory when context should outlive a single session. For example:

```text
Remember that our product name is always written "Acme Cloud", never "AcmeCloud", and check Supermemory for our other style rules before writing.
```

```text
Search Supermemory for what we decided about pricing for the annual plan, then draft the announcement.
```