Your Obsidian vault, connected to AI.
MindCache is an open-source MCP server that bridges your Obsidian vault with AI assistants. Search, capture, and connect your personal knowledge — instantly.
44 tools for finding, reading, writing, and organizing notes. Your AI can recall what you know, record what you learn, and connect ideas across your vault.
- An Obsidian vault (a folder of markdown files)
- Node.js 18+
No plugins required. MindCache reads your vault directly from the filesystem.
# Interactive setup
npx @augmnt-sh/mindcache init
# Add to Claude Code (auto-updates on each session)
claude mcp add --scope user mindcache -- npx @augmnt-sh/mindcache@latestThat's it. Claude Code now has access to your vault.
If you used @latest in the MCP command (recommended), updates are automatic — npx fetches the newest version each time Claude Code starts a new session.
If you installed globally:
npm update -g @augmnt-sh/mindcacheCheck your current version:
npx @augmnt-sh/mindcache --versionCreate ~/.config/mindcache/config.yml:
vault: ~/Documents/Obsidian Vaultdaily_notes:
folder: Dailyformat: YYYY-MM-DDtemplates:
folder: Templates/MindCacheinbox:
folder: MindCache/Inboxrequire_review: falseOr use environment variables:
export MINDCACHE_VAULT=~/Documents/Obsidian\ Vault| Tool | Description |
|---|---|
search | Full-text search with Obsidian operators |
ask | Natural language Q&A across your vault |
find_related | Notes connected via backlinks, tags, or content |
find_by_tag | Filter notes by tags |
find_by_date | Notes from a date range |
find_recent | Recently modified notes |
find_mentions | Where a term is mentioned |
| Tool | Description |
|---|---|
read_note | Full note content |
read_section | Content under a specific heading |
read_summary | Note with metadata (tags, links, word count) |
read_properties | YAML frontmatter only |
read_today | Today's daily note |
read_this_week | Daily notes from current week |
extract_links | All wikilinks and URLs from a note |
| Tool | Description |
|---|---|
remember | Quick capture to inbox |
remember_meeting | Structured meeting notes |
remember_decision | ADR-format decision log |
remember_idea | Capture an idea |
remember_learning | Save something learned |
remember_person | Person/contact note |
remember_reference | Bookmark with summary |
| Tool | Description |
|---|---|
log | Append to daily note |
log_task | Add task to daily note |
reflect | Reflection prompts |
| Tool | Description |
|---|---|
create_note | Create note with optional template |
append_to_note | Append to existing note |
update_section | Replace section content |
delete_note | Permanently delete a note |
| Tool | Description |
|---|---|
add_link | Insert wikilink between notes |
suggest_connections | AI-powered link suggestions |
find_gaps | Broken links (knowledge gaps) |
find_orphans | Disconnected notes |
| Tool | Description |
|---|---|
add_tag | Add tags to a note |
update_properties | Modify frontmatter |
rename_note | Rename a note |
move_note | Move to different folder |
| Tool | Description |
|---|---|
vault_overview | Stats, folders, tags |
list_tags | All tags with counts |
get_vault_structure | Folder tree |
| Tool | Description |
|---|---|
find_tasks | Find checkbox tasks |
complete_task | Mark task as done |
| Tool | Description |
|---|---|
bulk_tag | Add/remove tags across multiple notes |
daily_notes | List all daily notes with stats |
export_note | Export as clean markdown or JSON |
MindCache also exposes MCP resources for automatic context:
| Resource | Description |
|---|---|
vault://today | Today's daily note |
vault://recent | Recently modified notes |
vault://tags | Tag cloud |
vault://context | Project-relevant notes |
MindCache ships with 10 note templates: decision, meeting, learning, idea, person, project, book, article, weekly-review, session.
npx @augmnt-sh/mindcache # Start MCP server
npx @augmnt-sh/mindcache init # Interactive setup
npx @augmnt-sh/mindcache doctor # Diagnose issues
npx @augmnt-sh/mindcache config # Show configuration
npx @augmnt-sh/mindcache --help # Help
npx @augmnt-sh/mindcache --version # Versionclaude mcp add --scope user mindcache -- npx @augmnt-sh/mindcache@latestAdd to claude_desktop_config.json:
{
"mcpServers": {
"mindcache": {
"command": "npx",
"args": ["@augmnt-sh/mindcache@latest"]
}
}
}Add to MCP settings:
{
"mindcache": {
"command": "npx",
"args": ["@augmnt-sh/mindcache@latest"]
}
}MindCache runs entirely on your machine. Your notes never leave your computer. No cloud, no accounts, no telemetry.
See CONTRIBUTING.md for guidelines.
MIT - see LICENSE for details.