secondbrain-mcp
Allows an AI agent to list, search, read, and append to Markdown notes in an Obsidian vault, treating the vault as a typed tool surface.
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.
secondbrain-mcp
A tiny Model Context Protocol server that exposes a folder of Markdown notes to an AI agent. Instead of pasting files into the prompt, the model can list, search, read, and append to your notes through real tool calls.
I built this because most "second brain" setups (Obsidian, a Drive folder of Markdown, Notion exports) are just files on disk. The useful question is how an agent reads and writes them reliably without you babysitting the context window. MCP is the clean answer: the notes become a typed tool surface the model can call.
What MCP is, in one line
MCP is an open protocol that lets an LLM client (Claude Desktop, Claude Code, ...) discover and call external tools and data over a simple JSON-RPC channel — wire a capability in once, and any MCP-aware client can use it.
Related MCP server: obsidian_mcp
Tools
Tool | What it does |
| Every note with its title and size |
| Full-text search; returns the lines that match |
| Full text of one note |
| Append-only write — never silently rewrites |
Run it
pip install -r requirements.txt
python server.py # serves over stdioNotes live in ./notes. Point it elsewhere with SECONDBRAIN_DIR=/path/to/vault.
Connect it to Claude
Drop this into Claude Desktop's claude_desktop_config.json or a project .mcp.json
for Claude Code:
{
"mcpServers": {
"secondbrain": {
"command": "python",
"args": ["/abs/path/to/server.py"],
"env": { "SECONDBRAIN_DIR": "/abs/path/to/your/vault" }
}
}
}Then ask "search my notes for the deployment runbook" and the model calls
search_notes instead of guessing.
How it fits together
flowchart LR
A["Claude Desktop / Claude Code"] -- "MCP · JSON-RPC over stdio" --> B["secondbrain server"]
B --> C[("notes/*.md")]
B -. "list · search · read · append" .-> ADesign notes
Append-only writes.
append_noteadds; it never overwrites. An agent can capture a thought without ever silently destroying a note.Plain Markdown is the source of truth. No database, no lock-in — the same folder works in Obsidian or a Git repo.
stdio transport, so it drops into any local MCP client with zero network setup.
License
MIT
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
MCP-native notes and memory for ChatGPT, Claude, and other AI tools.
Persistent memory layer for AI tools. Save and recall notes across Claude and other MCP clients.
Notes and memory assistant: one Markdown vault that Claude, ChatGPT and any MCP client can share.
Shared Markdown notes for MCP-compatible AI tools.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to search, read, create, and append Apple Notes using MCP tools, supporting bulk folder reads and tag search.13 npmMIT
- FlicenseNot gradedqualityCmaintenanceEnables reading, writing, searching, and managing Obsidian vault notes through MCP tools and prompts, allowing AI agents to interact with local knowledge bases.-
- AlicenseAqualityBmaintenanceProvides an AI agent with a searchable markdown notes vault, offering tools to create, read, list, search, update, and delete notes stored as plain .md files.6MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI assistants to interact with a Markdown-based knowledge base with backlinks, tags, and full-text search, supporting note creation, reading, updating, renaming, and deletion through MCP tools.23 npmMIT