Obsidian MCP Server
by cyanheads
A Model Context Protocol server designed for LLMs to interact with Obsidian vaults. It enables AI assistants to seamlessly manage knowledge bases through a clean, flexible tool interface.
Last updated: N/A
What is Obsidian MCP Server?
The Obsidian MCP Server is a Model Context Protocol server that allows Large Language Models (LLMs) to interact with and manage Obsidian vaults. It provides a standardized interface for AI models to access and manipulate files, search content, and manage properties within an Obsidian vault.
How to use Obsidian MCP Server?
To use the server, you need to enable the Local REST API plugin in Obsidian, clone or install the server, configure the server settings in your MCP client (e.g., claude_desktop_config.json
), and set the required environment variables, including your Obsidian API key. Then, you can use the provided tools and resources to interact with your Obsidian vault.
Key features of Obsidian MCP Server
Atomic file/directory operations with validation
Full-text search with configurable context
Advanced JsonLogic queries for files, tags, and metadata
YAML frontmatter parsing and intelligent merging
API key auth with rate limiting and SSL options
Resource monitoring and health checks
Use cases of Obsidian MCP Server
Enabling AI assistants to manage and update notes in Obsidian vaults
Automating knowledge base updates based on LLM analysis
Building AI-powered search and retrieval systems for Obsidian content
Integrating Obsidian vaults with other AI tools and services
FAQ from Obsidian MCP Server
What is the Model Context Protocol (MCP)?
What is the Model Context Protocol (MCP)?
The Model Context Protocol (MCP) enables AI models to interact with external tools and resources through a standardized interface.
What is the purpose of the Obsidian MCP Server?
What is the purpose of the Obsidian MCP Server?
It allows LLMs to interact with Obsidian vaults, enabling AI assistants to manage knowledge bases.
What are the key features of the server?
What are the key features of the server?
Key features include file operations, search system, property management, and security & performance enhancements.
What environment variables are required?
What environment variables are required?
The required environment variable is OBSIDIAN_API_KEY
, which is your API key from Obsidian's Local REST API plugin settings.
How do I contribute to the project?
How do I contribute to the project?
Fork the repository, create a feature branch, and submit a Pull Request. For bugs and features, create an issue on GitHub.