Keephaven MCP
Long-term agent memory stored on your own Keephaven home server
- 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-mcpAdd 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:8790RequiredKEEPHAVEN_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.



