brain
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
๐ง Brain
English Documentation ยท ไธญๆๆๆกฃ ยท Architecture
CLI-first Obsidian for LLMs: Build your second brain with Markdown notes, bi-directional wikilinks, and high-performance full-text search. Implemented with zero external dependencies using the Python standard library.
๐๏ธ Vault Architecture: Core, Brain & Daily
The vault directory (defaults to ~/.brain or $BRAIN_VAULT) organizes memory into distinct tiers:
~/.brain/
โโโ core/ # Core directives, identity & soul [inti brain][soul]
โ โโโ soul.md # Agent identity, persona & foundational guidelines
โ โโโ memory.md # Persistent facts & long-term user profile
โโโ brain/ # Knowledge notes [judul][isi]
โ โโโ Concept A.md # [Title].md holding title and Markdown content
โ โโโ Concept B.md # Interconnected with [[wikilinks]] and #tags
โโโ daily/ # Episodic logs & journal entries
โ โโโ 2026-11-10.md # Daily notes auto-created by date
โโโ README.md # Vault overview and quick referencecore/[Core Brain / Soul]: Fundamental directives, persona, and core rules. Managed viabrain coreand MCP toolsbrain_get_core/brain_save_core.brain/[Title / Content]: Specific domain knowledge, ideas, documentation, and conceptual notes. Managed viabrain new,brain search, etc.daily/[Episodic Journal]: Daily logs and task lists managed viabrain daily.
Related MCP server: akatsuki
โจ Features
๐ Markdown Notes: Clean files with simple frontmatter (
tags/aliases) and standard Markdown formatting.๐ Obsidian-Style Wikilinks: Supports
[[Note]],[[Note|alias]], and[[Note#section]]with bi-directional backlink tracking.๐ท๏ธ Tagging System:
#ai,#notes/ml, with support for nested and international tags.๐ Full-Text Search Engine: Fast word-token search with built-in unigram + bigram support for CJK languages (no external tokenizer required). Weighted by title (3x), tags (2x), and content.
๐ธ๏ธ Interactive & Exportable Graph: ASCII adjacency view, Graphviz DOT, and JSON exports.
๐ Daily Notes: Automatic template creation for daily planning and episodic logs.
๐ง Integrity Tools: Orphan note detection, vault statistics, and rename with automatic global wikilink rewriting.
๐ป Interactive REPL: Run
brain replfor an interactive shell session.๐ค MCP Server (Model Context Protocol): Seamless long-term memory for Claude Code, Cursor, Codex, and any MCP-compatible AI client.
๐ Installation
One-line Install (Recommended)
Install or update Brain with a single command via curl | bash:
curl -fsSL https://raw.githubusercontent.com/Iky969/brain-llm/main/install.sh | bashManual Install via Git
git clone https://github.com/Iky969/brain-llm.git
cd brain-llm
pip install -e .โก Quick Start
# 1. Initialize the vault (~/.brain)
brain init
# 2. View or edit core identity [inti brain][soul]
brain core
brain core -e
# 3. Create domain knowledge notes in brain/ [judul][isi]
brain new "Machine Learning" -t ai ml
brain new "Deep Learning" -t ai ml -c "# Deep Learning\n\nBranch of [[Machine Learning]]."
# 4. Search and browse
brain search "learning" # Full-text search
brain list # List notes with folder/category indicator
brain links "Deep Learning" # Inspect forward links and backlinks
brain tags # View all tags
brain graph # Render ASCII graph (-f dot / -f json also available)
brain stats # View vault statistics
brain daily # Open or view today's daily log
brain repl # Enter interactive shellGlobal Options
--vault <dir>: Custom vault directory (defaults to~/.brain, or environment variableBRAIN_VAULT).EDITOR: Editor used bybrain openand-eflags (e.g.export EDITOR=nano).
๐ CLI Command Reference
Command | Aliases | Description |
|
| Initialize or verify vault structure ( |
|
| View, edit ( |
|
| Create note in |
|
| Open note in |
|
| Display note content ( |
|
| List notes with folder and tag columns ( |
|
| Full-text search across all notes ( |
|
| Delete note ( |
|
| Rename note and rewrite all |
|
| Inspect outlinks and incoming backlinks |
|
| List all tags or filter notes by a tag |
|
| View or create today's daily log ( |
|
| Export link graph ( |
|
| List orphan notes (notes with no inlinks or outlinks) |
|
| Vault statistics (notes, links, tags, orphans) |
|
| Enter interactive REPL shell |
|
| Launch MCP stdio server for LLM integration |
๐ค LLM & MCP Integration
Brain provides a built-in MCP (Model Context Protocol) server exposing tools for LLM agents:
brain_get_core: Retrieve core directives and soul identity.brain_save_core: Update core persona and persistent directives.brain_search: Full-text search across all notes with relevance scoring and snippets.brain_get: Fetch the full Markdown content of a note.brain_save: Create or update a note in the knowledge base.brain_delete: Delete a note.brain_list: List notes with category and tag filtering.brain_daily: Retrieve or append to today's daily log.brain_links: Inspect forward links and backlinks.brain_graph: Export link graph for contextual graph navigation.brain_tags: View tags index.brain_stats: Overview of vault health and stats.
Claude Code Setup
claude mcp add brain -- brain --vault ~/.brain mcpCursor Setup (~/.cursor/mcp.json)
{
"mcpServers": {
"brain": {
"command": "brain",
"args": ["--vault", "/home/your_user/.brain", "mcp"]
}
}
}๐ License
This project is licensed under the MIT License ยฉ 2026 Iky969.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogโฆ
This server cannot be deployed
Maintenance
Related MCP Connectors
Notes and memory assistant: one Markdown vault that Claude, ChatGPT and any MCP client can share.
Token-efficient MCP memory for Markdown vaults. Tiered search, GraphRAG, AI memories.
Serve a folder of Markdown notes as an MCP server: hybrid search, reading, and sourced answers.
One memory, every AI. A shared, user-owned markdown memory your AI clients read and write over MCP.
Related MCP Servers
- AlicenseAqualityBmaintenanceLocal MCP server for querying and maintaining a Markdown vault. Provides full-text search, backlinks, note retrieval, and optional confined write tools, without sending the whole vault to the client context.22110 PyPI1Apache 2.0
- AlicenseNot gradedqualityBmaintenanceExposes a living systems memory vault to autonomous agents, letting them search notes with BM25 ranking, read sections within token budgets, extract API/port/schema contracts, compute dependency blast radius, and run machine-verifiable invariant assertions before mutating code. It also supports surgical frontmatter edits, schema linting, wikilink integrity checks, and worklog recording, over stdio MCP.MIT
- AlicenseNot gradedqualityCmaintenanceExposes a local Markdown vault to AI agents over stdio, letting them search, read, create, update (with mtime-guarded writes), and append notes, as well as list and manage saved views. Write permissions can be toggled per group in settings, and all changes land as plain Markdown/YAML files in the chosen folder.MIT
- AlicenseBqualityBmaintenanceServes a Markdown memory vault to AI agents over MCP, letting them write, search, edit, and verify memories while full-text and graph indexes stay in sync in the background. Combines SQLite FTS5 retrieval with a Graphiti temporal knowledge graph so agents can recall both documents and entity facts over time.8MIT