obsidian-mcp

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

252
13

Obsidian MCP Server

smithery badge

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.

Warning!!!

Back up your Obsidian vault before use, as this MCP has read and write access.

Features

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.

Requirements

Requires Node.js 20 or higher and an Obsidian vault.

Install

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.

Development

Provides instructions for cloning the repository, installing dependencies, and building the project for development purposes.

Documentation

Links to documentation for creating new tools and tool examples.

Security

Highlights the importance of securing access to the Obsidian vault directory and reviewing tool actions.

Troubleshooting

Provides solutions for common issues like server connection problems, permission errors, and tool execution failures.

License

MIT

Repository

ST
StevenStavrakis

StevenStavrakis/obsidian-mcp

Created

December 22, 2024

Updated

March 28, 2025

Language

TypeScript

Category

Productivity