Brain Memory
Long-term Markdown memory for AI agents, shared across Claude, Cursor, Codex and more
- Pricing
- Open source
- Platforms
- CLI, self-hosted, macOS
- Runs
- Remotely
- Version
- 0.6.2
- Listing updated
- 3 days ago
About Brain Memory
Brain Memory is an open-source MCP server for knowledge and memory. It runs as a hosted remote server, so there is nothing to install locally.
Brain Memory stores each decision, convention or preference as a Markdown file with YAML frontmatter in ~/.brain/, with no database. Recall is computed from the files without embeddings or model calls, using keyword relevance, strength after decay, links between memories and the current project, so every agent gets the same ranking.
Memories follow published models: strength falls with an Ebbinghaus-style decay, recall strengthens a memory and surfaces linked ones, and a sleep cycle consolidates and prunes. Eight memory types decay at different rates, newer facts can supersede older ones, and procedures can be stored as SKILL.md files. Content from tools or the web waits for your approval before recall.
The hosted connector at mcp.brainmemory.ai uses OAuth and, per the connector README, serves the brain of the Google identity that signs in. Tools are brain_recall, brain_status, brain_use, brain_memorize, brain_pin, brain_unpin, brain_forget and brain_verify. The npm plugin is MIT licensed and runs locally with no account.
Install
Run in a terminal
claude mcp add --transport http brain https://mcp.brainmemory.ai/mcpAdd to Settings → Connectors → Add custom connector
https://mcp.brainmemory.ai/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"brain": {
"url": "https://mcp.brainmemory.ai/mcp"
}
}
}Add to .vscode/mcp.json
{
"servers": {
"brain": {
"type": "http",
"url": "https://mcp.brainmemory.ai/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"brain": {
"serverUrl": "https://mcp.brainmemory.ai/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"brain": {
"type": "http",
"url": "https://mcp.brainmemory.ai/mcp"
}
}
}Tools this server provides (8)
Taken from the project documentation; the running server may differ.
- brain_recall
- Ranked recall for a query.
- brain_status
- Memory count and last-updated for the brain.
- brain_use
- Switch between the account's brains.
- brain_memorize
- Save a memory.
- brain_pin
- Pin a memory.
- brain_unpin
- Unpin a memory.
- brain_forget
- Remove a memory.
- brain_verify
- Verify a memory.
What it does
- Markdown memories
- One file per memory with no database.
- Model-free recall
- Ranked by keyword, decayed strength, links and project.
- Decay and consolidation
- Unused memories fade and a sleep cycle prunes.
- Memory types
- Eight types with their own decay rates.
- Approval for external content
- Tool and web content waits for your approval.
- Sync options
- Git, encrypted export, synced folder or Brain Cloud.
Good for
- Keep project conventions across coding sessions
- Share one memory between Claude and Codex
- Record decisions and look them up later
- Store reusable procedures as skills
- Review which memories an agent has saved
Pricing
Open source
MIT plugin free; Brain Cloud sync optional
Prices change. Check brainmemory.ai before you buy.
Brain Memory FAQ
Is it free?
Yes, the plugin is MIT-licensed on npm as brain-memory; Brain Cloud sync is optional.
Where are memories stored?
In ~/.brain/ on your machine, or via the hosted connector tied to your sign-in.
Does it use a vector database?
No, recall is computed from the files without embeddings.
Which agents work?
Claude Code, Codex CLI, OpenCode, Copilot CLI, the Claude apps, ChatGPT and others.
Is Brain Memory free?
Yes. Brain Memory is open source, so you can use and self-host it for free.
How do I add Brain Memory to Claude Code?
Run this command in your terminal: claude mcp add --transport http brain https://mcp.brainmemory.ai/mcp
What are the best alternatives to Brain Memory?
The closest alternatives to Brain Memory are Codebase Memory, XERJ, Claude Code Ultimate Guide, Nautilus Compass Memory and note1.
Alternatives to Brain Memory

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Claude Code Ultimate Guide
MCP serverMCP server for searching the Claude Code Ultimate Guide from any MCP client
Runs locally- Open source
- 6.5K GitHub stars
- AI models and LLM tooling

Nautilus Compass Memory
MCP serverLocal-first long-term memory layer for AI agents, served over MCP
Not checked yet- 5 tools
- Remote
- Open source
- 1.3K GitHub stars
- Knowledge and memory

note1
MCP serverMCP server giving AI assistants search and summaries across your note1 meetings
- 4 tools
- Remote
- Free trial
- 1 GitHub star
- Productivity
MedXpert 图书馆连接器(通用版)
MCP serverLocal MCP server that searches and answers questions over your own Markdown wiki
Runs locally- 4 tools
- Open source
- Knowledge and memory