Obsidian MCP Server

Model Context Protocol (MCP) server for Obsidian vault integration. Enables AI assistants like Claude to read, write, search, and navigate your Obsidian notes.

Features

• Note CRUD: Create, read, update, delete notes with frontmatter support
• Search: Full-text search with tag and folder filtering
• Graph Navigation: Explore links, backlinks, and note relationships
• Daily Notes: Quick access to daily notes with template support
• Resources: Expose vault notes as MCP resources

Installation

git clone https://github.com/kirby-k-0723/obsidian-mcp.git
cd obsidian-mcp
npm install
npm run build

Configuration

Claude Code

Add to ~/.claude/settings.json:

{
  "mcpServers": {
    "obsidian": {
      "command": "node",
      "args": ["/path/to/obsidian-mcp/dist/index.js"],
      "env": {
        "OBSIDIAN_VAULT_PATH": "/path/to/your/vault"
      }
    }
  }
}

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):

{
  "mcpServers": {
    "obsidian": {
      "command": "node",
      "args": ["/path/to/obsidian-mcp/dist/index.js"],
      "env": {
        "OBSIDIAN_VAULT_PATH": "/path/to/your/vault"
      }
    }
  }
}

Available Tools

Tool	Description
list_notes	List all notes in vault with metadata (tags, links, backlinks)
read_note	Read note content and metadata
create_note	Create new note with optional frontmatter
update_note	Update existing note content
delete_note	Delete a note
append_to_note	Append content to existing note
search_notes	Search notes by content, with tag/folder filters
get_backlinks	Get all notes linking to a specific note
get_graph	Get note connection graph (links, backlinks, tags)
get_daily_note	Get today's or specific date's daily note
create_daily_note	Create daily note with optional template

Usage Examples

Once connected, you can ask Claude:

• "Show me all my notes tagged with #project"
• "Create a new note called 'Meeting Notes' with today's date"
• "What notes link to my 'Goals 2024' note?"
• "Search for notes mentioning 'machine learning'"
• "Add a task to today's daily note"

Environment Variables

Variable	Description	Default
OBSIDIAN_VAULT_PATH	Path to Obsidian vault	Required
MODE	Server mode: stdio or sse	stdio
PORT	HTTP port for SSE mode	3847

Development

# Development mode with hot reload
npm run dev

# Build TypeScript
npm run build

# Run production server
npm start

Project Structure

src/
  index.ts    # MCP server entry point, tool handlers
  types.ts    # TypeScript type definitions
  vault.ts    # Vault filesystem operations

License

ISC