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

Installation

NPX

npx -y obsidian-mcp /path/to/your/vault

Smithery

npx -y @smithery/cli install obsidian-mcp --client claude

From Source Code

git clone https://github.com/StevenStavrakis/obsidian-mcp
cd obsidian-mcp
npm install
npm run build

Configuration

Manual Claude Desktop Setup

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

Claude Desktop for Development

{
    "mcpServers": {
        "obsidian": {
            "command": "node",
            "args": ["<absolute-path-to-obsidian-mcp>/build/main.js", "/path/to/your/vault", "/path/to/your/vault2"]
        }
    }
}

Available Tools

Tool	Description
read-note	Read the contents of a note
create-note	Create a new note
edit-note	Edit an existing note
delete-note	Delete a note
move-note	Move a note to another location
create-directory	Create a new directory
search-vault	Search for notes in the vault
add-tags	Add tags to a note
remove-tags	Remove tags from a note
rename-tag	Rename a tag across all notes
manage-tags	List and organize tags
list-available-vaults	List all available vaults (helpful with multi-vault setups)

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

Notes

IMPORTANT: This MCP has read and write access to your Obsidian vault. Back up your vault before using. Requires Node.js 20 or higher. Configuration files: macOS: ~/Library/Application Support/Claude/claude_desktop_config.json, Windows: %APPDATA%\Claude\claude_desktop_config.json. Logs available at: macOS: ~/Library/Logs/Claude/mcp*.log, Windows: %APPDATA%\Claude\logs\mcp*.log