obsidian-mcp

obsidian-mcp

(by Steven Stavrakis) An MCP server for Obsidian.md with tools for searching, reading, writing, and organizing notes.

580
Stars
54
Forks
0
Releases

Overview

Obsidian MCP Server is an MCP (Model Context Protocol) server that enables AI assistants to interact with Obsidian vaults. It exposes tools for reading, creating, editing and managing notes and tags, facilitating AI-powered note management inside Obsidian. The server supports reading and searching notes, creating new notes and directories, editing existing notes, moving and deleting notes, and comprehensive tag management (add, remove, rename), plus the ability to search vault contents. It requires Node.js 20 or higher and an Obsidian vault. Installation can be done manually by configuring Claude Desktop to run the MCP server with absolute vault paths, or via Smithery. Development instructions show cloning the repository, installing dependencies, building, and wiring Claude Desktop to the built main.js. A security warning notes that the server has read/write access if enabled, so users should back up their vaults and review tool actions. Troubleshooting covers common issues and log locations for macOS and Windows. Documentation is available in the docs directory (creating-tools.md, tool-examples.md) to guide creating tools and examples.

Details

Owner
StevenStavrakis
Language
TypeScript
License
MIT License
Updated
2025-12-07

Features

Read and search notes in your vault

Read the contents of notes and search across the vault.

Create new notes and directories

Create new notes and folders within the vault.

Edit existing notes

Edit the content of existing notes.

Move and delete notes

Move notes to new locations and delete notes.

Manage tags (add, remove, rename)

Add, remove or rename tags across notes.

Search vault contents

Perform broad searches across vault contents to locate information.

Audience

AI assistantsInteract with Obsidian vaults to read, write, edit, and manage notes and tags via MCP.
Obsidian usersEnable AI-assisted searching, organization, and note management in Obsidian vaults via MCP.

Tags

ObsidianObsidian vaultMCPModel Context ProtocolnotesvaultreadwritesearchtagsdirectoriesClaude DesktopSmitheryNode.js