Obsidian MCP Plugin by Aaronsb enhances the mcp platform by embedding an MCP server directly within Obsidian's Node.js Electron environment. Built with JavaScript/TypeScript, it distributes via the Obsidian Community Plugin directory. This tool allows various AI assistants and clients, such as Claude Desktop, Claude Code, Cline, and Continue.dev, to interact directly with your Obsidian vault. It acts as a bridge, providing AI tools with access to vault content and operations, thereby expanding AI capabilities within a personal knowledge base.

What does Obsidian MCP Plugin connect to?

The Obsidian MCP Plugin connects to any Model Context Protocol (MCP)-compatible AI assistant or client. This includes Claude Desktop, Claude Code, Cline, and Continue.dev. It serves as an MCP server within Obsidian, providing AI tools direct vault access. The plugin supports HTTP transport and stdio via a .mcpb shim for specific clients. It also runs an HTTPS server, utilizing a self-signed certificate for secure communication with connected AI clients.

Core features and tools

The plugin exposes 8 powerful tools for AI interaction. Key callable tool categories include vault for operations like list, read, create, search, move, split, and combine. The edit tool handles smart editing, fuzzy text matching, appending content, and line-based modifications. view enables navigation and viewing file portions with context. workflow provides AI guidance and contextual hints, while system offers utilities such as server information and web fetching capabilities.

Who is it for?

The audience for Obsidian MCP Plugin includes users of AI assistants and agents who want to integrate their Obsidian vault for various tasks. This applies to those needing AI to read, write, search, and traverse their vault, or to act as a research assistant for summarization and information retrieval. It also serves users interested in semantic search and template integration within Obsidian. Skip this if you do not use AI assistants with a need for direct vault interaction.

How to get started

Access is granted through API keys and granular permissions, including a read-only mode and per-operation controls. The plugin supports HTTP transport and stdio via a .mcpb shim for specific clients.

Use cases

• Allowing AI assistants to read, write, search, and traverse the Obsidian vault.
• Enabling AI to act as a research assistant for summarization and information retrieval, such as summarizing research on machine learning optimization.
• Facilitating semantic search and template integration, where AI can search based on meaning and context, and execute Obsidian templates with dynamic parameters.

Obsidian MCP Plugin offers a powerful bridge between AI assistants and your Obsidian vault, enabling advanced knowledge management. It provides a rich set of tools for vault interaction, editing, and workflow guidance, all within a secure, permission-controlled environment. Users gain the ability to automate research, enhance content creation, and perform context-aware searches.