Obsidian MCP Server logo

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.

View on GitHub

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)?

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?

It allows LLMs to interact with Obsidian vaults, enabling AI assistants to manage knowledge bases.

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?

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?

Fork the repository, create a feature branch, and submit a Pull Request. For bugs and features, create an issue on GitHub.