Obsidian MCP

Example Use Cases

• 1

  Read the contents of specific notes or the currently active note in an Obsidian vault.

• 2

  Search and filter vault content programmatically using JsonLogic queries.

• 3

  Insert or modify note content relative to headings, block references, or frontmatter fields.

Description

This project provides a Node.js MCP server that connects to an Obsidian vault through the Local REST API plugin, enabling AI agents to read, write, list, and search notes programmatically. It implements tools such as readNote, readActiveNote, listNotes, patchNote (append/prepend/replace by heading, block, or frontmatter), and searchWithJsonLogic. It’s designed to be used with MCP-capable clients (e.g., Claude Desktop) to integrate vault contents into agent workflows. Setup requires Node.js, the Obsidian Local REST API plugin, and an API key.