This project provides an MCP (Model Context Protocol) server that allows AI assistants, specifically Claude Desktop, to interact with Obsidian vaults. It enables AI to read, create, edit, move, delete, and manage notes and tags within a user's Obsidian knowledge base, offering a powerful way to leverage AI for personal knowledge management.

How It Works

The server runs as a Node.js application, exposing a set of tools that an AI model can invoke. These tools directly interact with the file system of specified Obsidian vaults, performing operations like reading note content, creating new files, editing existing ones, and managing tags. This approach allows AI models to programmatically access and manipulate a user's notes without requiring manual copy-pasting or complex integrations.

Quick Start & Requirements

• Install: Manually add to Claude Desktop configuration (claude_desktop_config.json) or via Smithery CLI (npx -y @smithery/cli install obsidian-mcp --client claude).
• Requirements: Node.js 20 or higher.
• Setup: Requires configuring the absolute path to your Obsidian vault(s) in claude_desktop_config.json and restarting Claude Desktop.
• Docs: creating-tools.md, tool-examples.md

Highlighted Details

• Supports reading, creating, editing, moving, and deleting notes and directories.
• Enables comprehensive tag management: adding, removing, renaming, and listing.
• Includes a vault search functionality for finding notes.
• Offers tools for managing multiple vaults.

Maintenance & Community

The project is actively developed by StevenStavrakis. Community interaction channels are not explicitly mentioned in the README.

Licensing & Compatibility

• License: MIT
• Compatibility: Permissive MIT license allows for commercial use and integration with closed-source applications.

Limitations & Caveats

The project is in active development and has not been thoroughly tested. Users are strongly advised to back up their Obsidian vaults before use due to the server's read/write access capabilities.