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.

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
• An Obsidian vault

Available Tools

• 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 a different location
• create-directory - Create a new directory
• search-vault - Search 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 (helps with multi-vault setups)

Security

This server requires access to your Obsidian vault directory. When configuring the server, make sure to:

• Only provide access to your intended vault directory
• Review tool actions before approving them

Troubleshooting

Common issues:

1. Server not showing up in Claude Desktop

   • Verify your configuration file syntax
   • Make sure the vault path is absolute and exists
   • Restart Claude Desktop

2. Permission errors

   • Ensure the vault path is readable/writable
   • Check file permissions in your vault

3. Tool execution failures

   • Check Claude Desktop logs for any errors.