obsidian-mcp

MCP.Pizza Chef: StevenStavrakis

Point this at the folder your Obsidian vault lives in and a connected assistant can search your notes, open and read one, write new ones, edit, move or delete existing notes, and tidy up tags across the whole vault. It is set up for Claude Desktop with a short settings block naming your vault's location, and it handles more than one vault at a time. The author is blunt about the risk: it has full write access and is still in active development, so back up your vault first.

Unmaintained · No commits in 14 months.
Notes
Writing

Use This MCP server To

Search my whole vault for notes about one topic Create a new note from what we just discussed Rename a tag everywhere it appears in my vault Move an old note into a different folder Read an existing note and pull out the key points Add tags to a note I just wrote

README

Obsidian MCP Server

smithery badge

An MCP (Model Context Protocol) server that enables AI assistants to interact with Obsidian vaults, providing tools for reading, creating, editing and managing notes and tags.

Warning!!!

This MCP has read and write access (if you allow it). Please. PLEASE backup your Obsidian vault prior to using obsidian-mcp to manage your notes. I recommend using git, but any backup method will work. These tools have been tested, but not thoroughly, and this MCP is in active development.

Features

  • Read and search notes in your vault
  • Create new notes and directories
  • Edit existing notes
  • Move and delete notes
  • Manage tags (add, remove, rename)
  • Search vault contents

Requirements

  • Node.js 20 or higher (might work on lower, but I haven't tested it)
  • An Obsidian vault

Install

Installing Manually

Add to your Claude Desktop configuration:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
{
    "mcpServers": {
        "obsidian": {
            "command": "npx",
            "args": ["-y", "obsidian-mcp", "/path/to/your/vault", "/path/to/your/vault2"]
        }
    }
}

obsidian-mcp FAQ

Which apps does it work in?
Claude Desktop is what the instructions cover. Other MCP clients that accept a command-launched server can use the same settings.
Do I need a key?
No. It reads the vault folder on your own computer directly, with no account or sign-in.
Can I use this to have my assistant write notes into my vault?
Yes — it can create, edit, move and delete notes, which is exactly why the author asks you to back up first.
Is my vault safe?
Back it up before you start. The author says the tools are tested but not thoroughly, and the server has full write access to any folder you give it.
How hard is setup?
Paste a few lines into Claude Desktop's config with the full path to your vault, then restart the app. Node 20 or newer is required.
Can I use more than one vault?
Yes. List several vault paths and there is a tool for checking which ones are available.
What if it doesn't show up after restarting?
Check that the vault path is absolute and actually exists, then look at the Claude Desktop logs the project points to.