explaingit

markuspfundstein/mcp-obsidian

Analysis updated 2026-07-03

3,668PythonAudience · generalComplexity · 2/5Setup · moderate

TLDR

mcp-obsidian lets Claude AI read and write your Obsidian notes vault. Once set up, you can ask Claude to search your notes, summarize them, or create new ones on your behalf.

Mindmap

mindmap
  root((repo))
    What it does
      Claude reads notes
      Claude writes notes
      Vault search
    How it works
      Local REST API plugin
      MCP server
      Claude desktop config
    Operations
      List files
      Read and search
      Add or delete notes
    Audience
      Obsidian users
      AI power users
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Ask Claude to find and summarize your most recent meeting note directly from your Obsidian vault.

USE CASE 2

Search all your Obsidian notes for every mention of a project or technology using natural language with Claude.

USE CASE 3

Have Claude write a new formatted note in your vault and save it automatically, ready to share.

USE CASE 4

Use Claude to list files in a specific folder and identify notes that need follow-up.

What is it built with?

PythonMCPObsidian

How does it compare?

markuspfundstein/mcp-obsidianoop7/ytsagebelval/textrecognitiondatagenerator
Stars3,6683,6673,671
LanguagePythonPythonPython
Setup difficultymoderateeasyeasy
Complexity2/52/52/5
Audiencegeneralgeneraldata

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires the Obsidian desktop app with the Local REST API community plugin installed and its API key.

In plain English

This repository provides a bridge between Claude (the AI assistant made by Anthropic) and Obsidian, a popular note-taking app. Obsidian stores all your notes as plain text files on your computer in a folder called a vault. This bridge lets Claude read and write those files so you can ask it questions about your notes or have it create new ones on your behalf. The connection works through two pieces: a community plugin inside Obsidian called Local REST API, which exposes your vault over a local network connection, and this server, which Claude connects to using a protocol called MCP (Model Context Protocol). Once both are running and configured, Claude can list files in your vault, read specific notes, search across all notes for a phrase, add content to an existing note, or delete files. Setup requires installing the Local REST API plugin inside Obsidian, copying the API key it generates, and then adding a short configuration block to Claude's desktop app settings. That config block tells Claude where to find the server and how to authenticate. The README shows two approaches: passing the API key directly in the Claude app config or putting it in a local environment file. Some practical example uses described in the README include asking Claude to summarize the most recent meeting note, searching all notes for mentions of a specific technology, or having Claude write a summary note and format it so you can forward it by email. The server is written in Python and can be installed with a tool called uvx, which handles the Python environment automatically. A debugging tool called MCP Inspector is also available for developers who want to trace what the server is doing.

Copy-paste prompts

Prompt 1
Using mcp-obsidian, ask Claude to search my Obsidian vault for all notes mentioning 'project alpha' and give me a one-paragraph summary of each.
Prompt 2
Show me the exact config block to add to Claude's desktop app settings to connect it to my Obsidian vault using mcp-obsidian.
Prompt 3
Ask Claude via mcp-obsidian to read my meeting notes from this week and write a summary note I can forward by email.
Prompt 4
Have Claude list all files in my Obsidian 'Archive' folder and tell me which ones have not been modified in over a year.

Frequently asked questions

What is mcp-obsidian?

mcp-obsidian lets Claude AI read and write your Obsidian notes vault. Once set up, you can ask Claude to search your notes, summarize them, or create new ones on your behalf.

What language is mcp-obsidian written in?

Mainly Python. The stack also includes Python, MCP, Obsidian.

How hard is mcp-obsidian to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is mcp-obsidian for?

Mainly general.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Scan in gitsafehub Deploy in gitdeployhub markuspfundstein on gitmyhub

Verify against the repo before relying on details.