---
title: Supermemory
description: Recall relevant context, capture completed turns, and manage durable memory.
type: memory
keywords:
  - memory
  - long-term memory
  - semantic search
  - rag
  - conversation history
  - retrieval
  - Supermemory
---

# Supermemory

Memory provider integration for eve. Recall relevant context, capture completed turns, and manage durable memory.

## Install

Install the Supermemory provider for eve:

```bash
eve add memory/supermemory
```

This installs `@supermemory/eve` and writes a memory slot. The provider requires Node.js 24 or later and eve 0.47.3 or later.

## Quick start

Create a Supermemory API key and add it to the agent's environment:

```bash title=".env.local"
SUPERMEMORY_API_KEY=...
```

The registry creates this memory slot:

```ts title="agent/memory/supermemory.ts"
import supermemory from "@supermemory/eve";
import { defineMemory } from "eve/memory";
import { byPrincipal } from "eve/memory/scope";

export default defineMemory({
  description: "Recall and manage durable context for the current user.",
  provider: supermemory({
    apiKey: process.env.SUPERMEMORY_API_KEY!,
  }),
  scope: byPrincipal,
});
```

The filename creates the `supermemory` memory slot, so the provider's tools are named `supermemory__search`, `supermemory__remember`, and `supermemory__forget`. The provider uses eve's locked scope key to partition all reads and writes.

## Configure

`byPrincipal` keeps memory disabled for anonymous and runtime principals, and shares the local-development scope while you run `eve dev`. For a multi-tenant agent, replace it with a scope resolver that derives both tenant and caller identity from verified session context. See [Multi-tenant memory](/docs/patterns/multi-tenant-memory).

Supermemory automatically recalls relevant context before a turn and captures completed turns. It also provides tools to search, read sessions and documents, remember context, extract files, URLs, or text, and forget memories. The provider sends stored conversations and extracted sources to Supermemory; configure its retention and data handling for your application before enabling it for sensitive data.

Keep `SUPERMEMORY_API_KEY` in the environment rather than prompts or source control. You can change the container-tag prefix, automatic search, capture policy, and profile-context time zone through `supermemory(...)`. See the [Supermemory eve provider documentation](https://github.com/supermemoryai/eve-supermemory#readme) for all options and tool behavior.

[Read the full memory provider documentation](https://github.com/supermemoryai/eve-supermemory#readme)

---

For a semantic overview of all documentation, see [/sitemap.md](/sitemap.md)

For an index of all available documentation, see [/llms.txt](/llms.txt)

For agent-facing discovery, including API and MCP surfaces, see [/agents.md](/agents.md)