Obsidian MCP Server

Example Use Cases

• 1

  Search and retrieve relevant notes or passages from an Obsidian vault using simple text or JsonLogic-based queries.

• 2

  Read single or multiple note files and provide context-aware responses or summarizations of long notes.

• 3

  Create or modify notes programmatically (append, insert under headings, or update frontmatter) as part of automated workflows or assistants.

Description

This project implements the Obsidian Model Context Protocol (MCP) server in TypeScript, exposing read, search, and write tools for an Obsidian vault. It provides simple and advanced (JsonLogic) search, single and batch file reads, and file patch/append operations, plus a note-summarization prompt. The server is designed to run as an MCP process (stdio) and integrates with MCP-capable clients such as Claude Desktop. It requires Node.js and the Obsidian Local REST API plugin and uses an OBSIDIAN_API_KEY environment variable for access.