This repository provides an MCP server for Obsidian, enabling AI assistants to interact with your vault for reading, creating, editing, and managing notes and tags. Use with caution and back
This is an MCP (Model Context Protocol) server designed to allow AI assistants to interact with Obsidian vaults. It provides tools for reading, creating, editing, and managing notes and tags within your vault.
Back up your Obsidian vault before use, as this MCP has read and write access.
The server enables AI to: read and search notes, create new notes and directories, edit existing notes, move and delete notes, manage tags (add, remove, rename), and search vault contents.
Requires Node.js 20 or higher and an Obsidian vault.
Installation can be done manually by modifying the Claude Desktop configuration file (claude_desktop_config.json
) with the server command and vault path. Alternatively, it can be installed via Smithery.
Provides instructions for cloning the repository, installing dependencies, and building the project for development purposes.
Links to documentation for creating new tools and tool examples.
Highlights the importance of securing access to the Obsidian vault directory and reviewing tool actions.
Provides solutions for common issues like server connection problems, permission errors, and tool execution failures.
MIT
StevenStavrakis/obsidian-mcp
December 22, 2024
March 28, 2025
TypeScript