Setup

Before you start

A MemoryBase account (sign up here)
Node.js 18+ (download here — choose “LTS”)
OpenClaw or Hermes Agent installed and running

Option 1: Ask your agent to install (easiest)

If your agent is already running, just tell it to set up MemoryBase. Paste this into your chat:

OpenClaw
Hermes Agent

Install MemoryBase so you can access my conversation history and past decisions.

MemoryBase is an npm package that provides an MCP server for persistent memory.
Package: https://www.npmjs.com/package/memorybase

Steps:
1. Run: npm install -g memorybase
2. Run: memorybase login
   It will print a URL and a code. Send me the URL and code so I can
   authenticate from my browser. Wait for the command to complete before
   moving on.
3. Add this to your MCP config at ~/.openclaw/openclaw.json:
{
  "mcpServers": {
    "memorybase": {
      "command": "npx",
      "args": ["-y", "memorybase", "mcp"]
    }
  }
}
4. Restart your gateway to load the new MCP server.

After setup, the MCP server gives you these tools:
- search_memory(query) — semantic search across my conversations
- search_text(query) — full-text keyword search
- list_projects() — list all projects
- get_project_context(project_id) — get a project's full context
- list_conversations() — list recent conversations
- get_conversation(conversation_id) — get a specific conversation
- get_timeline() — browse timeline entries
- get_timeline_for_date(date) — view a specific day
- memory_status() — check indexing status

You also have CLI commands for quick access:
- memorybase search "<query>" — search memory from the terminal
- memorybase projects list — list all projects
- memorybase project <id> --pack — export a project's full context
- memorybase timeline list — browse recent activity
- memorybase timeline show <date> — view a specific day
- memorybase status — check indexing status

After restarting, verify by running: memorybase status

Install MemoryBase so you can access my conversation history and past decisions.

MemoryBase is an npm package that provides an MCP server for persistent memory.
Package: https://www.npmjs.com/package/memorybase

Steps:
1. Run: npm install -g memorybase
2. Run: memorybase login
   It will print a URL and a code. Send me the URL and code so I can
   authenticate from my browser. Wait for the command to complete before
   moving on.
3. Add this to your MCP config at ~/.hermes/config.yaml:
mcp_servers:
  memorybase:
    type: stdio
    command: npx
    args: ["-y", "memorybase", "mcp"]
4. Restart to load the new MCP server.

After setup, the MCP server gives you these tools:
- search_memory(query) — semantic search across my conversations
- search_text(query) — full-text keyword search
- list_projects() — list all projects
- get_project_context(project_id) — get a project's full context
- list_conversations() — list recent conversations
- get_conversation(conversation_id) — get a specific conversation
- get_timeline() — browse timeline entries
- get_timeline_for_date(date) — view a specific day
- memory_status() — check indexing status

You also have CLI commands for quick access:
- memorybase search "<query>" — search memory from the terminal
- memorybase projects list — list all projects
- memorybase project <id> --pack — export a project's full context
- memorybase timeline list — browse recent activity
- memorybase timeline show <date> — view a specific day
- memorybase status — check indexing status

After restarting, verify by running: memorybase status

Once done, test it by asking:

What do you know about my recent conversations?

Option 2: Manual setup

If you prefer to set things up yourself, run these commands on the machine where your agent is running:

Install the MemoryBase CLI

npm install -g memorybase

memorybase login

This opens your browser. Sign in with your MemoryBase account.

Add MemoryBase to your agent's MCP config

OpenClaw
Hermes Agent

Edit ~/.openclaw/openclaw.json and add under mcpServers:

{
  "mcpServers": {
    "memorybase": {
      "command": "npx",
      "args": ["-y", "memorybase", "mcp"]
    }
  }
}

Restart your OpenClaw gateway to pick up the new server.Optionally, reference MemoryBase in your SOUL.md:

## Memory

You have access to my conversation history via the MemoryBase MCP server.
Use `search_memory` to find relevant past discussions before starting new tasks.
Use `get_project_context` to load full project context when working on known projects.

Edit ~/.hermes/config.yaml and add:

mcp_servers:
  memorybase:
    type: stdio
    command: npx
    args: ["-y", "memorybase", "mcp"]

Hermes discovers MemoryBase tools on next startup.To limit which tools are exposed, use tool filtering:

mcp_servers:
  memorybase:
    type: stdio
    command: npx
    args: ["-y", "memorybase", "mcp"]
    include:
      - search_memory
      - get_project_context
      - get_timeline

Verify

Ask your agent:

What do you know about my recent conversations?

It should return results from your conversation history.

Available tools

Once connected, your agent has access to these MCP tools:

Tool	Description
`search_memory`	Semantic search across all conversations and projects
`search_text`	Full-text keyword search
`get_project_context`	Load a project’s full context pack
`list_projects`	List all projects
`list_conversations`	List recent conversations
`get_conversation`	Get a specific conversation
`get_timeline`	Browse timeline entries
`get_timeline_for_date`	View a specific day’s activity
`memory_status`	Check indexing status

See the MCP tools reference for full details on each tool.

Get Started

Features

Claude Code & Codex

AI Agents

Before you start

Option 1: Ask your agent to install (easiest)

Option 2: Manual setup

Available tools

​Before you start

​Option 1: Ask your agent to install (easiest)

​Option 2: Manual setup

​Available tools

Before you start

Option 1: Ask your agent to install (easiest)

Option 2: Manual setup

Available tools