Obsidian MCP Server logo

Obsidian MCP Server

by MCP-Mirror

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 install Node.js, enable the Local REST API plugin in Obsidian, clone or install the server, configure the server settings with the necessary environment variables (including the Obsidian API key), and then add the server configuration to your MCP client settings.

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

Use cases of Obsidian MCP Server

  • Enabling AI assistants to manage and update notes in Obsidian vaults

  • Automating content creation and modification within Obsidian

  • Building AI-powered search and retrieval systems for Obsidian knowledge bases

  • Integrating Obsidian 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 required plugin for Obsidian?

The Local REST API plugin is required in Obsidian to use this server.

What are the required environment variables?

The required environment variable is OBSIDIAN_API_KEY, which is your API key from Obsidian's Local REST API plugin settings.

How do I set up SSL?

For Windows, you can either disable SSL verification for development or import the certificate from Obsidian's Local REST API settings into the Windows Certificate Manager for production. For other systems, add the certificate to Keychain Access (macOS) or ca-certificates (Linux).

What are the different search tools?

The server provides obsidian_find_in_file for text search and obsidian_complex_search for metadata/tag filtering.