claude-obsidian

An MCP server that gives Claude Code full access to your Obsidian vault through Obsidian's built-in CLI.

Claude can read notes, search your vault, navigate the graph, manage tasks, edit properties, create and modify notes — all without leaving the terminal.

Prerequisites

• Obsidian with CLI support (v1.8+, macOS). The CLI binary lives at /Applications/Obsidian.app/Contents/MacOS/obsidian.
• Obsidian must be running — the CLI communicates with the running app.
• Node.js v18+
• Claude Code installed

Install

Via npx (recommended)

No clone or build needed:

claude mcp add obsidian -s user \
  -e OBSIDIAN_VAULT_PATH=/path/to/your/vault \
  -e OBSIDIAN_CLI_PATH=/Applications/Obsidian.app/Contents/MacOS/obsidian \
  -- npx -y claude-obsidian

From source

git clone https://github.com/Marcusk19/claude-obsidian.git
cd claude-obsidian
npm install
npm run build

claude mcp add obsidian -s user \
  -e OBSIDIAN_VAULT_PATH=/path/to/your/vault \
  -e OBSIDIAN_CLI_PATH=/Applications/Obsidian.app/Contents/MacOS/obsidian \
  -- node /absolute/path/to/claude-obsidian/dist/index.js

Restart Claude Code to pick up the new server.

Environment variables

| Variable | Default | Description | |----------|---------|-------------| | OBSIDIAN_VAULT_PATH | /Users/mkok/obsidian-git-sync | Absolute path to your Obsidian vault | | OBSIDIAN_CLI_PATH | /Applications/Obsidian.app/Contents/MacOS/obsidian | Path to the Obsidian CLI binary | | OBSIDIAN_SESSIONS_FILE | claude-sessions.md | Vault-relative path to the session tracking file read by obsidian_session context |

Tools

Read-only

| Tool | Description | |------|-------------| | obsidian_vault_info | Vault overview, file/folder listing, recents, bookmarks | | obsidian_read | Read note contents, daily note, file info, or outline. Includes daily:recent for fetching the last N daily notes | | obsidian_search | Full-text search with optional line context | | obsidian_graph | Backlinks, outgoing links, orphans, dead-ends, unresolved links | | obsidian_tags | List all tags or get info about a specific tag | | obsidian_properties | List properties or read a property value | | obsidian_tasks | List tasks, filter by status/file/daily note | | obsidian_aliases | List aliases in the vault | | obsidian_session | Session orchestration: context (start-of-session briefing) and morning (daily kickoff agenda) |

Destructive

These tools require confirmation before Claude executes them.

| Tool | Description | |------|-------------| | obsidian_write | Create notes, append/prepend to notes or daily notes | | obsidian_manage | Move, rename, or delete notes | | obsidian_property_write | Set or remove properties on notes | | obsidian_task_update | Toggle, complete, or uncomplete tasks |

Usage examples

Once registered, just ask Claude naturally:

• "What's in my daily note?"
• "Search my vault for kubernetes"
• "Show me all incomplete tasks"
• "Append 'Review PR #42' to today's daily note"
• "What notes link to my Konflux project note?"
• "List all tags sorted by count"

Session workflows

These workflows require no CLAUDE.md configuration — the tool descriptions teach Claude when to invoke them automatically.

Start of session — say "catch me up", "what are we working on?", or "start work":

Claude calls obsidian_session context, which returns in one shot:

• Contents of your sessions file (claude-sessions.md by default)
• All open tasks
• Today's daily note

Morning kickoff — say "morning briefing", "start my day", or "daily kickoff":

Claude calls obsidian_session morning, which returns:

• Last 3 daily notes for recent context
• All open tasks
• Your projects index (1_Projects/index.md) if it exists

Session handoff — at the end of a session, ask Claude to write a handoff note:

Claude uses obsidian_write daily:append to append a summary to today's daily note, and obsidian_write create to update claude-sessions.md. Recommended template:

## Session handoff — 2026-03-08

### What we did
- ...

### Open threads
- [ ] ...

### Next steps
- ...

Reading recent context — ask Claude for the last few days of notes:

Claude calls obsidian_read with action=daily:recent, days=3.

Verify

After registering, run /mcp in Claude Code to confirm the server is connected and all 14 tools are available.

Uninstall

claude mcp remove obsidian -s user

License

MIT