Dreamd
Local memory store for coding agents that traces every lesson back to its source
- 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-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"dreamd": {
"command": "npx",
"args": [
"-y",
"dreamd-mcp"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"dreamd": {
"command": "npx",
"args": [
"-y",
"dreamd-mcp"
]
}
}
}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.


