Obsidian MCP

An MCP server that gives Claude Code read/write access to your Obsidian vault. Search, create, edit, and organize your notes through natural conversation.

Read & Write Notes

Create, edit, and append to markdown files directly in your Obsidian vault through Claude.

Full-Text Search

Search across your entire vault by content. Find notes, patterns, and context instantly.

Daily Notes

Read or append to daily notes with configurable date format. Document sessions automatically.

Browse & Navigate

List files and folders in your vault. Understand project structure at a glance.

Built-in Prompts

Three structured prompts for session-start, session-end, and project check-in workflows.

Secure & Local

Only accesses your configured vault directory. No data leaves your machine via the server.

Quick Start

# Install and register with Claude Code (no install needed)
claude mcp add obsidian -- uvx obsidian-mcp

# Then tell Claude:
# "Configure obsidian vault at /path/to/your/vault"

Alternatively, install persistently via pipx install obsidian-mcp or pip install obsidian-mcp.

Tools

Tool Description
obsidian_configure Set vault path and daily notes settings
obsidian_status Show current configuration and vault stats
obsidian_read Read a note's contents
obsidian_write Create or overwrite a note
obsidian_append Append to a note, optionally under a heading
obsidian_search Search notes by content
obsidian_list Browse vault structure
obsidian_daily Read or append to daily notes

Built-in Prompts

Prompt Description
session-start Review daily notes and project context before starting work
session-end Document accomplishments, decisions, and open questions
project-checkin Review and update a specific project's documentation

Configuration

Config is stored at ~/.config/obsidian-mcp/config.json:

{
  "vault_path": "/path/to/your/vault",
  "daily_notes_folder": "Daily Notes",
  "daily_notes_format": "%Y-%m-%d"
}
Option Default Description
vault_path (required) Absolute path to your Obsidian vault
daily_notes_folder Daily Notes Folder for daily notes
daily_notes_format %Y-%m-%d Date format for daily note filenames

Example Usage

Once configured, ask Claude things like: