Obsidian Connector

MCP server to connect Claude (Code + Desktop) bidirectionally with Obsidian vaults.

Features

Read (5 tools)

• search_notes - Full-text search with filtering

• read_note - Read single note with metadata

• list_notes - List and filter notes

• get_structure - Vault overview and statistics

• get_backlinks - Find notes linking to a note

Write (4 tools)

• create_note - Create new notes

• edit_note - Edit notes (full/append/section)

• update_frontmatter - Update metadata

• delete_note - Soft delete to .trash

Organize (4 tools)

• move_note - Move/rename with link updates

• add_links - Add wikilinks between notes

• suggest_structure - Get organizational suggestions

• apply_template - Apply templates from _templates/

Resources

• obsidian://structure - Vault overview

• obsidian://note/{path} - Individual notes

Installation

npm install -g obsidian-connector

Or use directly with npx:

npx obsidian-connector

Configuration

Add to your Claude MCP settings (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "obsidian": {
      "command": "npx",
      "args": ["obsidian-connector"],
      "env": {
        "VAULT_PATH": "/path/to/your/vault"
      }
    }
  }
}

For Claude Code, add to ~/.claude/config.json:

{
  "mcpServers": {
    "obsidian": {
      "command": "npx",
      "args": ["obsidian-connector"],
      "env": {
        "VAULT_PATH": "/path/to/your/vault"
      }
    }
  }
}

Security

• Only accesses files within configured vault path

• Path traversal protection

• Soft delete (moves to .trash instead of permanent deletion)

• No network connections

License

MIT