Skip to content
MCP server

Keephaven MCP

Long-term agent memory stored on your own Keephaven home server

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted
Runs
Locally
Version
0.1.0
Listing updated
today

Similar MCP servers

About Keephaven MCP

Keephaven MCP is an open-source MCP server for knowledge and memory. It runs locally on your machine and is started by your AI client.

Where most memory servers keep notes with a vendor, this one writes them to a Keephaven box on your home network. Each agent gets its own folder, so one agent cannot see another's files, and you issue its token under Settings > Agents. The box keeps only a fingerprint of the token, and revoking it cuts the agent off immediately while its files stay until you delete them.

Alongside plain files there is an append-only journal the agent can add to but never edit or delete. Writes can use an etag check so two sessions do not overwrite each other, and you can set a size limit per agent or make one read-only.

The machine running the agent must reach the box over the same network, its Wi-Fi or Tailscale. The README is frank about gaps: tokens travel over plain HTTP on the home network, and backup between two real boxes is not yet tested. A single Python file lets you try it without hardware.

Install

Run in a terminal

claude mcp add keephaven-mcp --env KEEPHAVEN_URL='<KEEPHAVEN_URL>' --env KEEPHAVEN_TOKEN='<KEEPHAVEN_TOKEN>' -- npx -y @dafarusd/keephaven-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "keephaven-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@dafarusd/keephaven-mcp"
      ],
      "env": {
        "KEEPHAVEN_URL": "<KEEPHAVEN_URL>",
        "KEEPHAVEN_TOKEN": "<KEEPHAVEN_TOKEN>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "keephaven-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@dafarusd/keephaven-mcp"
      ],
      "env": {
        "KEEPHAVEN_URL": "<KEEPHAVEN_URL>",
        "KEEPHAVEN_TOKEN": "<KEEPHAVEN_TOKEN>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "keephaven-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@dafarusd/keephaven-mcp"
      ],
      "env": {
        "KEEPHAVEN_URL": "<KEEPHAVEN_URL>",
        "KEEPHAVEN_TOKEN": "<KEEPHAVEN_TOKEN>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "keephaven-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@dafarusd/keephaven-mcp"
      ],
      "env": {
        "KEEPHAVEN_URL": "<KEEPHAVEN_URL>",
        "KEEPHAVEN_TOKEN": "<KEEPHAVEN_TOKEN>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "keephaven-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@dafarusd/keephaven-mcp"
      ],
      "env": {
        "KEEPHAVEN_URL": "<KEEPHAVEN_URL>",
        "KEEPHAVEN_TOKEN": "<KEEPHAVEN_TOKEN>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • KEEPHAVEN_URLThe box's memory API, e.g. http://keephaven-xxxx.local:8790Required
  • KEEPHAVEN_TOKENAgent token from Settings > Agents on the boxRequired

Tools this server provides (8)

Taken from the project documentation; the running server may differ.

memory_write
Saves a file, with an optional etag check.
memory_read
Reads a file back with its etag.
memory_list
Lists files, optionally under a folder.
memory_search
Case-insensitive search across files and the journal.
memory_delete
Deletes a file.
journal_append
Adds an entry to the append-only journal.
journal_read
Reads recent journal entries, oldest first.
memory_status
Shows the agent name, read-only state and quota used.

What it does

Per-agent folders
Each agent sees only its own files.
Append-only journal
The agent can add entries but never edit or delete them.
Etag-checked writes
Stops two sessions from overwriting each other.
Quotas and read-only
Cap an agent's size or make it read-only.
Instant revoke
Revoking a token cuts the agent off at once.

Good for

  • Give Claude Code a memory that stays on your own hardware
  • Keep a journal an agent cannot rewrite
  • Share notes across sessions without a cloud service
  • Trial the setup locally with the bundled Python file

Pricing

Open source

MIT licence; needs a Keephaven box or the free local test service

Keephaven MCP FAQ

Which clients work?

MCP clients that run local servers, such as Claude Desktop, Claude Code and Cursor.

What does it need?

Node 20 or newer and a reachable Keephaven box, or the bundled Python file for a local trial.

Is traffic encrypted?

Tokens travel over plain HTTP on the home network; over Tailscale they are encrypted.

What licence is it?

MIT.

Is Keephaven MCP free?

Yes. Keephaven MCP is open source, so you can use and self-host it for free.

How do I add Keephaven MCP to Claude Code?

Run this command in your terminal: claude mcp add keephaven-mcp --env KEEPHAVEN_URL='<KEEPHAVEN_URL>' --env KEEPHAVEN_TOKEN='<KEEPHAVEN_TOKEN>' -- npx -y @dafarusd/keephaven-mcp

What are the best alternatives to Keephaven MCP?

The closest alternatives to Keephaven MCP are Codebase Memory, XERJ, Claude Code Ultimate Guide, Nautilus Compass Memory and NeuroStack.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers