Happy slice of mcp pizzaMCP.pizza

mcp-obsidian

MCP.Pizza Chef: MarkusPfundstein

Your assistant gains the ability to browse your vault, open any note, search across everything you have ever written, and append or edit text in place. It works with Claude Desktop and any assistant that accepts a short configuration snippet. Obsidian needs to be running with the free Local REST plugin switched on, and you copy the key that plugin shows you into the setup.

Notes
Writing

Use This MCP server To

Summarize my last meeting note and save it as a new note Find every note that mentions a client and explain the context Append today's ideas to my running project note Search my vault for something I only half remember writing Draft a note from this conversation without leaving the chat

README

MCP server for Obsidian

MCP server to interact with Obsidian via the Local REST API community plugin.

server for Obsidian MCP server

Components

Tools

The server implements multiple tools to interact with Obsidian:

  • list_files_in_vault: Lists all files and directories in the root directory of your Obsidian vault
  • list_files_in_dir: Lists all files and directories in a specific Obsidian directory
  • get_file_contents: Return the content of a single file in your vault.
  • search: Search for documents matching a specified text query across all files in the vault
  • patch_content: Insert content into an existing note relative to a heading, block reference, or frontmatter field.
  • append_content: Append content to a new or existing file in the vault.
  • delete_file: Delete a file or directory from your vault.

Example prompts

Its good to first instruct Claude to use Obsidian. Then it will always call the tool.

The use prompts like this:

  • Get the contents of the last architecture call note and summarize them
  • Search for all files where Azure CosmosDb is mentioned and quickly explain to me the context in which it is mentioned
  • Summarize the last meeting notes and put them into a new note 'summary meeting.md'. Add an introduction so that I can send it via email.

Configuration

Obsidian REST API Key

There are two ways to configure the environment with the Obsidian REST API Key.

  1. Add to server config (preferred)

mcp-obsidian FAQ

Which apps does this work in?
Claude Desktop is the documented setup, and any assistant that lets you paste a short configuration snippet can use it too.
Do I need a key?
Yes. Install Obsidian's free Local REST plugin, turn it on, and copy the key from its settings into the configuration.
Can I use this to write notes, not just read them?
Yes — it creates new notes, appends to existing ones, and can insert text under a specific heading.
Does Obsidian have to be open?
Yes. The connection runs through a plugin inside Obsidian, so the app needs to be running on the same computer.
How hard is the setup?
Roughly ten minutes: install the plugin, copy the key, paste a short block into your assistant's configuration file.
Can it delete my notes?
It can delete files when asked, so turn on file recovery or keep a backup before giving it broad instructions.