Obsidian MCP Server

@StevenStavrakis

About Obsidian MCP Server

A simple MCP server for Obsidian

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "obsidian": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp",
        "/path/to/your/vault"
      ]
    }
  }
}

Tools

Read the contents of a note

Create a new note

Edit an existing note

Delete a note

Move a note to a different location

Create a new directory

Search notes in the vault

Add tags to a note

Remove tags from a note

Rename a tag across all notes

List and organize tags

List all available vaults (helps with multi-vault setups)

Overview

What is Obsidian MCP Server?

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. It is designed for Obsidian users who want to let AI assistants directly manage their note-taking vault.

How to use Obsidian MCP Server?

Install manually by adding the server to your Claude Desktop configuration file, specifying the absolute path(s) to your Obsidian vault(s). The server runs via npx obsidian-mcp <vault-path>. A Smithery installation option is available but not recommended by the author. Requires Node.js 20 or higher.

Key features of Obsidian MCP Server

Read and search notes in your vault
Create new notes and directories
Edit and delete existing notes
Move notes between locations
Manage tags (add, remove, rename)
Support for multiple vaults

Use cases of Obsidian MCP Server

AI assistant reads and summarises notes from your vault
Automatically create, organise, or update notes via prompts
Bulk tag management across multiple notes
Move or restructure notes within the vault

FAQ from Obsidian MCP Server

What backup is recommended before using Obsidian MCP Server?

The README strongly advises backing up your Obsidian vault prior to use, recommending git or any backup method, because the server has read and write access and is in active development.

What are the runtime requirements?

Node.js 20 or higher and an Obsidian vault are required.

Where does the data live?

The server reads and writes directly to your local Obsidian vault directory. No cloud storage is mentioned; all data stays on your machine.

What are known limitations?

The tools have been tested but not thoroughly, and the server is in active development.

What transport does the server use?

The server is configured to run as a local MCP server via stdio (command-line interface). No network transports are mentioned.

Frequently asked questions

What backup is recommended before using Obsidian MCP Server?

The README strongly advises backing up your Obsidian vault prior to use, recommending git or any backup method, because the server has read and write access and is in active development.