Happy slice of mcp pizzaMCP.pizza

obsidian-mcp

MCP.Pizza Chef: newtype-01

Once it is set up, your assistant can list and read the notes in your vault, write new ones, edit or delete existing ones, move files between folders, and run a full-text search across everything you have ever written down. It can also spot mentions of other note titles and turn them into proper links. You need the Obsidian desktop app and one free companion plugin installed from inside Obsidian; there is no paid account, but no new code has landed since August 2025.

Unmaintained Β· no commits since August 2025; no replacement named
Notes
Writing

Use This MCP server To

Find every note where I mentioned a client by name Draft a new note and file it in the right folder Summarize this week's meeting notes into one page Rename and move stray files to tidy up my vault Add a paragraph under a specific heading in an existing note Turn plain mentions of note titles into clickable links

README

Obsidian MCP (Model Context Protocol) Server

English | δΈ­ζ–‡

This project implements a Model Context Protocol (MCP) server for connecting AI models with Obsidian knowledge bases. Through this server, AI models can directly access and manipulate Obsidian notes, including reading, creating, updating, and deleting notes, as well as managing folder structures.

Created by huangyihe

Features

  • πŸ”— Seamless Obsidian Integration: Direct access to Obsidian knowledge bases through MCP protocol
  • πŸ“ Complete Note Management: Read, create, update, and delete notes with advanced text replacement
  • πŸ“ Folder Operations: Create, rename, move, and delete folders with full hierarchy support
  • πŸ” Intelligent Search: Full-text search across all file types with smart scoring
  • πŸ€– AI-Powered Analysis: NEW Strategic insights using TRILEMMA-PRINCIPLES framework
  • πŸ”— Auto Backlink Generation: NEW Intelligent detection and conversion of note names to wikilinks
  • ⚑ Precision Editing: Advanced PATCH operations with heading and block-level targeting
  • πŸš€ Dual API Strategy: Obsidian REST API with filesystem fallback for maximum reliability
  • 🎯 Context Optimization: Smart content summarization for LLM context length management
  • πŸ“Š Batch Processing: Efficient bulk operations with progress tracking

Supported Tools

The MCP server provides the following comprehensive tools:

πŸ“‹ Core Operations

  • list_notes: List notes in the Obsidian vault with optional folder filtering
    • NEW recursive parameter: Control whether to list files recursively in subdirectories (default: true)
    • Use recursive: false to list only files in the specified folder without subdirectories
  • read_note: Read the content of a specific note in the Obsidian vault
  • read_multiple_notes: Read content from multiple notes simultaneously for batch processing
  • create_note: Create a new note in the Obsidian vault with full content
  • delete_note: Delete a note from the Obsidian vault
  • search_vault: Advanced search across all file types with filename and content matching
  • move_note: Move or rename notes to new locations (supports all file types including PDFs)
  • manage_folder: Complete folder CRUD operations (create/rename/move/delete)

πŸš€ Advanced Features

obsidian-mcp FAQ

Is this still being looked after?
The last code change landed in August 2025, so it has sat untouched for roughly a year. It generally still works, but nobody is shipping fixes, and the project does not point anyone toward a replacement.
Which apps does it work in?
Any assistant app that supports MCP, including Claude Desktop and Cursor. There is a one-click extension file for apps that accept them, and a small config snippet for everything else.
Do I need to pay for anything or get a key?
There is no paid account and no outside service. You do need the access token that the free Obsidian companion plugin generates, which you paste into the setup once.
Can I use this to reorganize a messy vault?
Yes β€” it can rename notes, move them between folders, and create, rename, or delete folders, so you can describe the structure you want and let the assistant do the shuffling.
Can it change or delete my notes, or only read them?
It can do both. Creating, editing, moving, and deleting are all supported, so keep a backup or use version history before letting it loose on a vault you care about.
Does my Obsidian app need to be open?
Normally yes, because it talks to Obsidian through the companion plugin. It can fall back to reading the files on disk directly when the plugin is unreachable.
How hard is the setup?
Moderate. Installing the Obsidian plugin, copying its token, and pasting a short config block takes about ten minutes and no programming.