Skip to main content

​
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: 
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
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:
1

Install the MemoryBase CLI

npm install -g memorybase
2

Sign in to your account

memorybase login
This opens your browser. Sign in with your MemoryBase account.
3

Add MemoryBase to your agent's MCP config

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.
4

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:
ToolDescription
search_memorySemantic search across all conversations and projects
search_textFull-text keyword search
get_project_contextLoad a project’s full context pack
list_projectsList all projects
list_conversationsList recent conversations
get_conversationGet a specific conversation
get_timelineBrowse timeline entries
get_timeline_for_dateView a specific day’s activity
memory_statusCheck indexing status
See the MCP tools reference for full details on each tool.