supermemory · local

endpoint

http://localhost:6767

api key

sm_9zkGP…4ut8

data directory

/.supermemory

01 — build

Build with supermemory local

Use the same SDK and REST API as the cloud, just pointed at your machine. Whatever you build here is portable — flip the base URL and ship it to production.

install the sdk

npm install supermemory
# or: bun add supermemory · pnpm add supermemory

use it

import Supermemory from "supermemory"

const client = new Supermemory({
  apiKey: "sm_9zkGPM9jUhd5pSdexwMkfj_iBGdwAAO0UPxciWaYpYLVtG9MB627XekE7p5z7erCLGkDeeEfU6tZA7WauPt4ut8",
  baseURL: "http://localhost:6767",
})

await client.add({
  content: "running on my laptop. zero cloud.",
})

const results = await client.search.execute({
  q: "what's running on my laptop?",
})

curl, if you prefer

curl -X POST http://localhost:6767/v3/documents \
  -H "Authorization: Bearer sm_9zkGPM9jUhd5pSdexwMkfj_iBGdwAAO0UPxciWaYpYLVtG9MB627XekE7p5z7erCLGkDeeEfU6tZA7WauPt4ut8" \
  -H "Content-Type: application/json" \
  -d '{"content": "supermemory is running locally!"}'

02 — use

Use with your agents

Point your existing tools at this local instance. Click any plugin for setup steps — base URL and key are pre-filled for you.

Claude Code Persistent memory across coding sessions. Auto-recalls relevant context at session start.

Point Claude Code at this server

Add to your shell profile so the plugin uses your local instance:

export SUPERMEMORY_BASE_URL="http://localhost:6767"
export SUPERMEMORY_CC_API_KEY="sm_9zkGPM9jUhd5pSdexwMkfj_iBGdwAAO0UPxciWaYpYLVtG9MB627XekE7p5z7erCLGkDeeEfU6tZA7WauPt4ut8"

Install the plugin

Inside a Claude Code session, run:

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

OpenCode Semantic search across previous sessions, auto-capture of coding decisions.

Point OpenCode at this server

Add to your shell profile:

export SUPERMEMORY_BASE_URL="http://localhost:6767"
export SUPERMEMORY_API_KEY="sm_9zkGPM9jUhd5pSdexwMkfj_iBGdwAAO0UPxciWaYpYLVtG9MB627XekE7p5z7erCLGkDeeEfU6tZA7WauPt4ut8"

Install the plugin

Use --no-tui for non-interactive environments:
```
bunx opencode-supermemory@latest install
```
Verify ~/.config/opencode/opencode.jsonc

Should include:
```
{
  "plugin": ["opencode-supermemory"]
}
```

OpenClaw Multi-platform memory across Telegram, WhatsApp, Discord, Slack.

Install the plugin

From your OpenClaw project:

openclaw plugins install @supermemory/openclaw-supermemory

Configure for local

Run setup, paste the api key shown above, and enter the local base URL when prompted:

openclaw supermemory setup
# base url:  http://localhost:6767
# api key:   sm_9zkGPM9jUhd5pSdexwMkfj_iBGdwAAO0UPxciWaYpYLVtG9MB627XekE7p5z7erCLGkDeeEfU6tZA7WauPt4ut8

Hermes Memory for the Hermes agent. Semantic search and conversation capture.

Start the memory wizard

On the host running Hermes:
```
hermes memory setup
```

Choose Supermemory, then point it at local

When prompted, paste the base URL and api key shown above:

base url: http://localhost:6767
api key:  sm_9zkGPM9jUhd5pSdexwMkfj_iBGdwAAO0UPxciWaYpYLVtG9MB627XekE7p5z7erCLGkDeeEfU6tZA7WauPt4ut8

Cursor Persistent AI memory for Cursor via the local HTTP API.

Point Cursor at this server

This self-hosted binary does not host an MCP protocol endpoint. Use the REST API (or SDK) with your local key. Cloud MCP remains at https://mcp.supermemory.ai/mcp.

export SUPERMEMORY_BASE_URL="http://localhost:6767"
export SUPERMEMORY_API_KEY="sm_9zkGPM9jUhd5pSdexwMkfj_iBGdwAAO0UPxciWaYpYLVtG9MB627XekE7p5z7erCLGkDeeEfU6tZA7WauPt4ut8"

# Example: add a memory
curl -X POST "$SUPERMEMORY_BASE_URL/v3/documents" \
  -H "Authorization: Bearer $SUPERMEMORY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"content": "notes from this Cursor session"}'

OpenAI Codex Persistent memory for the Codex CLI. Recalls context before each prompt.

Point Codex at this server

Add to your shell profile:

export SUPERMEMORY_BASE_URL="http://localhost:6767"
export SUPERMEMORY_CODEX_API_KEY="sm_9zkGPM9jUhd5pSdexwMkfj_iBGdwAAO0UPxciWaYpYLVtG9MB627XekE7p5z7erCLGkDeeEfU6tZA7WauPt4ut8"

Install the plugin

Run:
```
npx codex-supermemory@latest install
```

openapi spec api reference docs ↗ github ↗

your memory layer is live.

this is what it remembers.

Build with supermemory local

Use with your agents