Enables secure, local Model Context Protocol integration for AI applications to access, search, and interact with Obsidian vaults via semantic search, template execution, and controlled API communication.
Unlock the full potential of MCP Tools for Obsidian through LangDB's AI Gateway. Get enterprise-grade security, analytics, and seamless integration with zero configuration.
Free tier available • No credit card required
Discover shared experiences
Features | Installation | Configuration | Troubleshooting | Security | Development | Support
MCP Tools for Obsidian enables AI applications like Claude Desktop to securely access and work with your Obsidian vault through the Model Context Protocol (MCP). MCP is an open protocol that standardizes how AI applications can interact with external data sources and tools while maintaining security and user control. 1
This plugin consists of two parts:
When you install this plugin, it will help you set up both components. The MCP server acts as a secure bridge between your vault and AI applications like Claude Desktop. This means AI assistants can read your notes, execute templates, and perform semantic searches - but only when you allow it and only through the server's secure API. The server never gives AI applications direct access to your vault files. 2
Privacy Note: When using Claude Desktop with this plugin, your conversations with Claude are not used to train Anthropic's models by default. 3
When connected to an MCP client like Claude Desktop, this plugin enables:
All features require an MCP-compatible client like Claude Desktop, as this plugin provides the server component that enables these integrations. The plugin does not modify Obsidian's functionality directly - instead, it creates a secure bridge that allows AI applications to work with your vault in powerful ways.
[!Important] This plugin requires a secure server component that runs locally on your computer. The server is distributed as a signed executable, with its complete source code available in
packages/mcp-server/. For details about our security measures and code signing process, see the Security section.
Clicking the install button will:
After clicking the "Install Server" button in the plugin settings, the plugin will automatically:
While the configuration process is automated, it requires your explicit permission to install the server binary and modify the Claude Desktop configuration. No additional manual configuration is required beyond this initial setup step.
If you encounter issues:
The MCP server binaries are published with SLSA Provenance attestations, which provide cryptographic proof of where and how the binaries were built. This helps ensure the integrity and provenance of the binaries you download.
To verify a binary using the GitHub CLI:
Install GitHub CLI:
# macOS (Homebrew) brew install gh # Windows (Scoop) scoop install gh # Linux sudo apt install gh # Debian/Ubuntu
Verify the binary:
gh attestation verify --owner jacksteamdev
The verification will show:
This verification ensures the binary hasn't been tampered with and was built directly from this repository's source code.
Please report security vulnerabilities via our security policy. Do not report security vulnerabilities in public issues.
This project uses a monorepo structure with feature-based architecture. For detailed project architecture documentation, see .clinerules.
Some code in this project was implemented using the AI coding agent Cline. Cline uses cline_docs/ and the .clinerules file to understand project architecture and patterns when implementing new features.
This project uses a Bun workspace structure:
packages/
├── mcp-server/ # Server implementation
├── obsidian-plugin/ # Obsidian plugin
└── shared/ # Shared utilities and types
bun install
bun run build
bun run dev
bun test
Please see CONTRIBUTING.md for detailed guidelines.
See CHANGELOG.md for a list of changes in each release.
MIT License
For more information about the Model Context Protocol, see MCP Introduction ↩
For a list of available MCP Clients, see MCP Example Clients ↩
For information about Claude data privacy and security, see Claude AI's data usage policy ↩
Requires Obsidian plugin Local REST API ↩
Requires Obsidian plugin Smart Connections ↩
Requires Obsidian plugin Templater ↩
Shared threads will appear here, showcasing real-world applications and insights from the community. Check back soon for updates!
Manage and scale multiple Model Context Protocol (MCP) servers with a centralized dashboard, real-ti...
Enables AI assistants to access, search, and filter Intercom customer support conversations and tick...
Enables AI assistants to access and interact with your Mealie recipe database via Model Context Prot...
Enables Model Context Protocol integration for efficient, version-specific search of MkDocs-powered ...
Provides standardized Model Context Protocol (MCP) access to YÖKATLAS data, enabling programmatic se...