Obsidian MCP Server

Example Use Cases

• 1

  List and discover all files inside a user's Obsidian vault to decide what context to load.

• 2

  Read contents of specific or fuzzy-matched markdown notes and gather open TODO items across the vault.

• 3

  Create or update markdown notes (including creating directories) so they can write summaries, standups, or edit notes programmatically.

Description

This project implements a simple Model Context Protocol (MCP) server for interacting with an Obsidian vault. It exposes read tools (list filenames, read specific files, gather open TODOs) and a write tool (create/update markdown files, creating directories as needed). The server runs standalone (Node.js) so agents can access the vault without the Obsidian app running and can be integrated with clients like Claude Desktop and Cursor. It emphasizes minimal, direct filesystem access rather than being a full-featured Obsidian plugin.