Skip to content
MCP server

Dreamd

Local memory store for coding agents that traces every lesson back to its source

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

Similar MCP servers

About Dreamd

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

Most agent memory is a black box. This server keeps it as plain files inside your repository: episodes are lines in a JSONL file, lessons live in a Markdown file, and each lesson cites the events it was promoted from. A periodic dream cycle clusters episodes by action and writes a lesson, then commits it to git.

When an agent keeps repeating bad advice, a blame command lists the stored memories behind a recall with ids, timestamps and scores. A forget command removes the event and the lesson state naming it, with a dry run and an optional receipt file. A doctor check recomputes the provenance ledger's Merkle root and flags orphaned or corrupt edges.

The README is candid about limits: it does not detect or block poisoned writes, the ledger and receipts are unsigned, and the source harness is asserted by the caller. Recall is lexical, ranked by BM25 and salience; vector recall is not shipped. With an API key the dream cycle can use an LLM under a 10 cent per-cycle cap, otherwise it writes a deterministic lesson.

Install

Run in a terminal

claude mcp add dreamd -- npx -y dreamd-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "dreamd": {
      "command": "npx",
      "args": [
        "-y",
        "dreamd-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "dreamd": {
      "command": "npx",
      "args": [
        "-y",
        "dreamd-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "dreamd": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "dreamd-mcp"
      ]
    }
  }
}

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

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

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

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

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

Tools this server provides (2)

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

search_nodes
Search stored memory and recall prior context, with the source harness on every hit.
append_node
Write an episode to memory.

What it does

Blame for memories
Lists the stored memories behind a recall, with ids, source and score.
Forget with receipt
Removes an event and its lesson state, with dry run and receipt file.
Provenance ledger
Records which event fed which lesson and checks it with a Merkle root.
Git-reviewed lessons
Each dream cycle commits its output so lessons can be reviewed and reverted.
Plain-file storage
JSONL and Markdown that cat, grep and git log can read.

Good for

  • Find which stored memory caused a wrong agent answer
  • Review what agents learned in a pull request
  • Remove a poisoned or mistaken memory with proof
  • Share one memory store across Claude Code, Cursor and Cline

Pricing

Open source

Apache-2.0 core, self-hosted

Dreamd FAQ

How do I install it?

Run npx -y dreamd-mcp setup to scaffold the .agent folder and wire your harness, then your harness spawns npx -y dreamd-mcp over stdio.

Does it block poisoned memory?

No. The README says it does not detect or block poisoned writes; it makes bad memory traceable and removable.

Which clients work?

Claude Code, Cursor, Cline and other MCP-aware harnesses.

Does it need a network?

Not by default. Without an API key the dream cycle makes no network call.

Is Dreamd free?

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

How do I add Dreamd to Claude Code?

Run this command in your terminal: claude mcp add dreamd -- npx -y dreamd-mcp

What are the best alternatives to Dreamd?

The closest alternatives to Dreamd are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.

Where this comes from

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

How AIPoweredBot checks servers