You've had thousands of AI conversations. You can't search any of them. ⬆️ Auto-playing preview — click here for full video with audio Documentation · Quickstart · ❓ FAQ · All 25 Tools If this is useful, a ⭐ helps others find it. Restart Claude. 25 tools available. Keyword search works immediately. Alternative: pip install Setup for specific clients After setup, just say "use brain" in an
Add this skill
npx mdskills install mordechaipotash/brain-mcpPowerful local conversation memory with 25 MCP tools for cognitive state reconstruction and semantic search
1# 🧠 brain-mcp23**You've had thousands of AI conversations. You can't search any of them.**45[](https://brainmcp.dev)6[](https://python.org)7[](https://modelcontextprotocol.io)8[](https://lancedb.com)9[](LICENSE)10[](https://pypi.org/project/brain-mcp/)11[](https://github.com/mordechaipotash/brain-mcp/actions)1213<p align="center">14 <img src="assets/demo-autoplay.gif" alt="brain-mcp Demo" width="640"/>15</p>1617<p align="center"><i>⬆️ Auto-playing preview — <a href="https://github.com/user-attachments/assets/1571c120-2c69-4a92-baa1-76c512485064">click here for full video with audio</a></i></p>18192021<p align="center">22 <b><a href="https://brainmcp.dev">📚 Documentation</a></b> · <b><a href="https://brainmcp.dev/docs/quickstart">🚀 Quickstart</a></b> · <b><a href="https://brainmcp.dev/faq">❓ FAQ</a></b> · <b><a href="https://brainmcp.dev/docs/tools">🔧 All 25 Tools</a></b>23</p>2425<p align="center">26 <sub>If this is useful, a ⭐ helps others find it.</sub>27</p>2829---3031## Install3233```bash34pipx install brain-mcp # recommended (isolated env, on your PATH)35brain-mcp init # discover your conversations36brain-mcp ingest # import them (fast, no GPU)37brain-mcp setup claude # auto-configure Claude Desktop + Code38```3940Restart Claude. **25 tools available.** Keyword search works immediately.4142```bash43# Optional: enable semantic search (downloads ~1.5GB embedding model)44pipx inject brain-mcp sentence-transformers einops45brain-mcp embed46```4748<details>49<summary>Alternative: pip install</summary>5051```bash52pip install brain-mcp53brain-mcp init && brain-mcp ingest54brain-mcp setup claude5556# Optional: semantic search57pip install brain-mcp[embed]58brain-mcp embed59```6061> **Note:** If you install in a virtualenv, make sure `brain-mcp` is on your PATH — Claude Desktop/Code needs to find the binary. `pipx` handles this automatically.6263</details>6465<details>66<summary>Setup for specific clients</summary>6768```bash69brain-mcp setup claude # auto-detect: configures both Desktop + Code70brain-mcp setup claude-desktop # Claude Desktop only71brain-mcp setup claude-code # Claude Code only72brain-mcp setup cursor # Cursor73brain-mcp setup windsurf # Windsurf74```7576</details>7778---7980## Using It8182After setup, just say **"use brain"** in any conversation with Claude, Cursor, or Windsurf. Your AI instantly gains access to your full thinking history.8384That's it. No special syntax. Just talk to your AI and it searches your brain when relevant.8586---8788## What You Can Do8990| Ask your AI | What happens |91|-------------|-------------|92| "What did I figure out about sleep last month?" | Finds your insights across 12 conversations you forgot you had |93| "Search everything I've discussed about marketing" | 23 conversations across 8 months, with quotes — in 12ms |94| "Where did I leave off with the business plan?" | Reconstructs your context — open questions, decisions, next steps |95| "How has my thinking about career changes evolved?" | Tracks your opinion trajectory from doubt → clarity |96| "What would it cost to switch focus right now?" | Quantifies what you'd abandon — open threads, unfinished thinking |97| "What do I actually think about AI?" | Synthesizes YOUR views from 31 past conversations into one answer |9899Works for **researchers, writers, students, founders, developers** — anyone who thinks with AI.100101---102103## The Problem Nobody Talks About104105You had a breakthrough at 2am last Tuesday. You laid out a whole framework in a conversation with Claude. It was brilliant.106107You can't find it. You can't even remember which conversation it was in.108109**Every week, millions of people pour their best thinking into AI conversations — and lose all of it.** ChatGPT's "memory" stores a few fun facts. Claude's import tool gives you a markdown summary of a summary. None of them let you *search your own thinking*.110111brain-mcp doesn't store facts. It reconstructs **cognitive state** — where you were in a problem, what you'd decided, what questions were still open, and what it would cost to switch away.112113> *Built with ADHD in mind. If your brain drops context constantly, this is your external hard drive.*114115### Without vs. With116117**Without brain-mcp:**118119> *"I had this great idea about the business plan last month... let me search my chat history... which conversation was it... was it ChatGPT or Claude..."*120>121> **30 minutes later:** Maybe 60% recovered. If you're lucky.122123**With brain-mcp:**124125```126> "Where did I leave off with the business strategy?"127128🧠 business-strategy — exploring stage129Open questions: 12 | Decisions made: 8130131❓ Top open:132 - Should I focus on B2B or B2C first?133 - What pricing model fits the early stage?134135✅ Recent decisions:136 - Target solo developers initially137 - Open-source core, paid hosting layer138139💬 Found across: 15 ChatGPT + 8 Claude + 3 Claude Code conversations140141⏱️ 12ms142```14314412 milliseconds to reconstruct the mental state that took weeks to build. Across every AI tool you've used. That's real data, not a mockup.145146---147148## How It Works149150**Your conversations → Your brain → Your AI**1511521. **You already have the data.** Claude Code sessions, ChatGPT exports, Claude Desktop — they're files on your machine.1532. **brain-mcp indexes them.** Keyword search works instantly. Add embeddings for semantic search.1543. **Your AI gets 25 new tools.** Ask Claude "where did I leave off?" and it searches your brain. 12ms.155156All data stays on your machine. Embedding model runs locally. **No cloud. No API costs.**157158---159160## 25 Tools161162### 🧠 Cognitive Prosthetic (8)163164The tools that make this different from every other memory system.165166| Tool | What it does | Speed |167|------|-------------|-------|168| `tunnel_state` | "Load your save game" — reconstructs where you were in any domain | 12ms |169| `context_recovery` | Full re-entry brief with summaries, open questions, decisions | 12ms |170| `switching_cost` | Quantified cost of switching between domains | 9ms |171| `open_threads` | Everything unfinished, everywhere | 2.7s |172| `dormant_contexts` | Abandoned domains with open questions you forgot about | 2.7s |173| `cognitive_patterns` | When and how you think best, with data | 10ms |174| `tunnel_history` | Engagement timeline for a domain | 5ms |175| `trust_dashboard` | System-wide proof the safety net works | 59ms |176177### 🔍 Search (6)178179| Tool | What it does |180|------|-------------|181| `semantic_search` | Vector search via LanceDB (768d nomic embeddings) |182| `search_conversations` | Keyword search across all conversations |183| `unified_search` | Search conversations + GitHub + markdown at once |184| `search_summaries` | Structured summaries (extract: decisions/questions/quotes) |185| `search_docs` | Markdown corpus search |186| `unfinished_threads` | Threads with open questions by domain |187188### 🔬 Synthesis (4)189190| Tool | What it does |191|------|-------------|192| `what_do_i_think` | Synthesized view of your position on any topic |193| `alignment_check` | Check decisions against your own stated principles |194| `thinking_trajectory` | How an idea evolved over time |195| `what_was_i_thinking` | Month-level snapshot of your focus |196197### 💬 Conversation + Stats (5)198199`get_conversation` · `conversations_by_date` · `brain_stats` · `query_analytics` · `github_search`200201### ⚙️ Meta (2)202203`list_principles` · `get_principle`204205---206207## Progressive Tiers208209Every tool works at every tier — just with increasing depth:210211| What you have | What works |212|---------------|-----------|213| Just conversations | Keyword search, date browsing, stats |214| + Embeddings | Semantic search, synthesis, trajectory |215| + Summaries | Full prosthetic tools with structured domain analysis |216217---218219## Comparison220221| | **brain-mcp** | **Mem0** | **Khoj** | **Letta (MemGPT)** |222|---|---|---|---|---|223| **Memory model** | Conversation archaeology — reconstructs cognitive state | Key-value fact store | Hybrid search over docs | Tiered agent memory |224| **State recovery** | 8 prosthetic tools (tunnel state, switching cost, dormancy) | ❌ | ❌ | ❌ |225| **Data source** | Your existing AI conversations (auto-discovered) | Runtime extractions | Personal documents | Agent conversation history |226| **Runs where** | 100% local (Apple Silicon optimized) | Cloud API or self-hosted | Self-hosted or cloud | Self-hosted or cloud |227| **Domain tracking** | 25 cognitive domains with stages, open questions, decisions | ❌ | ❌ | ❌ |228| **Cost** | ~$0.05/day | Free tier / paid | Free / self-hosted | Free / self-hosted |229| **Protocol** | MCP (Claude, Cursor, any client) | REST API | REST API + web UI | REST API |230231---232233234## 🔒 Privacy & Security235236- **100% local** — all data stays on your machine237- **No telemetry** — zero tracking, zero phone-home238- **No cloud dependency** — works offline after initial setup239- **No accounts** — no sign-up, no API keys for core features240- **You own everything** — MIT licensed, your data is yours241- **Open source** — audit every line of code242243---244245## CLI246247```bash248brain-mcp init # Discover conversation sources249brain-mcp init --full # Discover + import + embed (one command)250brain-mcp setup claude # Configure Claude Desktop / Claude Code251brain-mcp setup cursor # Configure Cursor252brain-mcp doctor # Health check253brain-mcp sync # Incremental update254brain-mcp status # One-line status255```256257---258259## Supported Sources260261| Source | Auto-detected | Status |262|--------|:---:|--------|263| Claude Code | ✅ | Supported |264| Claude Desktop | ✅ | Supported |265| ChatGPT | ✅ | Supported |266| Clawdbot | ✅ | Supported |267| Cursor | — | Coming soon |268| Windsurf | — | Coming soon |269| Generic JSONL | Manual | Supported |270271---272273## Requirements274275- Python 3.11+276- ~500MB disk, ~2GB RAM for embedding277- macOS (Apple Silicon recommended), Linux, or WSL278279---280281## Part of the Ecosystem282283| Repo | What |284|------|------|285| **[brain-mcp](https://github.com/mordechaipotash/brain-mcp)** | Memory — 25 MCP tools, cognitive prosthetic |286| **[QinBot](https://github.com/mordechaipotash/qinbot)** | AI on a $50 dumb phone — no browser, no apps |287| **[local-voice-ai](https://github.com/mordechaipotash/local-voice-ai)** | Voice — Kokoro TTS + Parakeet STT, zero cloud |288| **[agent-memory-loop](https://github.com/mordechaipotash/agent-memory-loop)** | Cron + memory cascade for AI agents |289| **[brain-canvas](https://github.com/mordechaipotash/brain-canvas)** | Visual display for any LLM |290| **[x-search](https://github.com/mordechaipotash/x-search)** | Search X/Twitter from terminal via Grok |291| **[mordenews](https://github.com/mordechaipotash/mordenews)** | Automated daily AI podcast |292| **[live-translate](https://github.com/mordechaipotash/live-translate)** | Real-time Hebrew→English translation |293294--295## Contributing296297See [CONTRIBUTING.md](CONTRIBUTING.md) for development setup, testing, and PR guidelines. All contributions welcome.298299---300301## License302303MIT — see [LICENSE](LICENSE). See [CHANGELOG.md](CHANGELOG.md) for version history.304305---306307<div align="center">308309*Built because losing your train of thought shouldn't mean starting over.*310311**[brainmcp.dev](https://brainmcp.dev)** · **[Full Docs](https://brainmcp.dev/docs/quickstart)** · **[PyPI](https://pypi.org/project/brain-mcp/)**312313</div>314
Full transparency — inspect the skill content before installing.