hypermemory · local

endpoint

http://localhost:6767

api key

check terminal or local api-key file

data directory

/data

01 — build

Build with hypermemory 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 @hypermemory/sdk
# or: bun add hypermemory · pnpm add hypermemory

use it

import HyperMemory from "@hypermemory/sdk"

const client = new HyperMemory({
  apiKey: "<YOUR_API_KEY>",
  baseURL: "http://localhost:6767",
})

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

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 <YOUR_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{"content": "hypermemory is running locally!"}'

02 — use

Use with your agents

Point your existing tools at this local instance. Click any plugin for setup steps — use the key printed in your terminal.

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 HYPERMEMORY_BASE_URL="http://localhost:6767"
export HYPERMEMORY_CC_API_KEY="<YOUR_API_KEY>"
```

Install the plugin

Inside a Claude Code session, run:

/plugin marketplace add greenfieldsh/claude-hypermemory
/plugin install claude-hypermemory

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

Point OpenCode at this server

Add to your shell profile:

export HYPERMEMORY_BASE_URL="http://localhost:6767"
export HYPERMEMORY_API_KEY="<YOUR_API_KEY>"

Install the plugin

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

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

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

Install the plugin

From your OpenClaw project:

openclaw plugins install @hypermemory/openclaw-hypermemory

Configure for local

Run setup, paste the api key shown above, and enter the local base URL when prompted:
```
openclaw hypermemory setup
# base url:  http://localhost:6767
# api key:   <YOUR_API_KEY>
```

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

Start the memory wizard

On the host running Hermes:
```
hermes memory setup
```
Choose HyperMemory, then point it at local

When prompted, paste the base URL and api key shown above:
```
base url: http://localhost:6767
api key:  <YOUR_API_KEY>
```

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 HyperMemory MCP (local stdio)

export HYPERMEMORY_BASE_URL="http://localhost:6767"
export HYPERMEMORY_API_KEY="<YOUR_API_KEY>"

# Example: add a memory
curl -X POST "$HYPERMEMORY_BASE_URL/v3/documents" \
  -H "Authorization: Bearer $HYPERMEMORY_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 HYPERMEMORY_BASE_URL="http://localhost:6767"
export HYPERMEMORY_CODEX_API_KEY="<YOUR_API_KEY>"

Install the plugin

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

openapi spec api reference docs ↗ github ↗

your memory layer is live.

this is what it remembers.

Build with hypermemory local

Use with your agents