Skip to content
MCP server

Brain Memory

Long-term Markdown memory for AI agents, shared across Claude, Cursor, Codex and more

Install
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/mcp

Add to Settings → Connectors → Add custom connector

https://mcp.brainmemory.ai/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "brain": {
      "url": "https://mcp.brainmemory.ai/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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

  1. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  2. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  3. MCP 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
  4. Local-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
  5. note1

    MCP server

    MCP server giving AI assistants search and summaries across your note1 meetings

    • 4 tools
    • Remote
    • Free trial
    • 1 GitHub star
    • Productivity