</>MCP Agents Market
MCP Server

mcp-obsidian

by MarkusPfundstein4.4kPythonUpdated 2026-08-31

MCP server that interacts with Obsidian via the Obsidian rest API community plugin

Claude Desktop

mcp-obsidian is an MCP server that enables AI assistants to interact with Obsidian vaults through the Obsidian Local REST API community plugin. It provides tools for reading, searching, and modifying notes programmatically, allowing assistants like Claude to browse your knowledge base, retrieve file contents, search across documents, and create or update notes. The server communicates with a running Obsidian instance over HTTP, giving AI agents direct access to your personal knowledge management system.

Key Features

Browse vault structure with list_files_in_vault and list_files_in_dir to explore directories
Retrieve note contents with get_file_contents for reading individual markdown files
Search across all vault documents using text queries to find relevant notes
Insert content relative to headings, block references, or frontmatter using patch_content
Append new content to existing or new files in the vault
Delete files and directories programmatically
Docker support for containerized deployment without local Python installation
Configurable connection via environment variables for API key, host, and port

Use Cases

  • 01Summarize recent meeting notes and automatically create formatted email-ready summaries
  • 02Search for technical references (e.g., Azure CosmosDB mentions) and extract context across multiple notes
  • 03Retrieve and summarize architecture decision records or design documents
  • 04Automatically organize and update vault content based on AI analysis
  • 05Create new notes with structured content generated by AI assistants
  • 06Query your personal knowledge base during AI-assisted research and writing

Related MCP Servers

View more

mcp-obsidian — FAQ

What is mcp-obsidian?+

mcp-obsidian is an MCP server that connects AI assistants to your Obsidian vault through the Obsidian Local REST API plugin, enabling programmatic access to read, search, and modify your notes.

How do I install mcp-obsidian in Claude Desktop?+

Add the server configuration to claude_desktop_config.json (~/Library/Application Support/Claude/ on macOS, %APPDATA%/Claude/ on Windows) with the command 'uvx' and args 'mcp-obsidian', plus environment variables for your Obsidian API key, host, and port. Restart Claude Desktop after saving the configuration.

What do I need before using mcp-obsidian?+

You must install and enable the Obsidian Local REST API community plugin in Obsidian, then copy the API key from the plugin settings. Python 3.11 or higher is required if running locally (or use the Docker option).

Which AI clients work with mcp-obsidian?+

The server works with Claude Desktop and any MCP-compatible client. It uses the standard MCP protocol over stdio for communication.

Is mcp-obsidian free to use?+

Yes, mcp-obsidian is open source and free to use. The Obsidian Local REST API plugin it depends on is also a free community plugin.

Where do I find my Obsidian API key?+

After installing the Obsidian Local REST API community plugin, open Obsidian settings, navigate to the plugin's configuration page, and copy the API key displayed there. The default port is 27124.

How do I install mcp-obsidian?+

Open the source repository on GitHub and follow its README. mcp-obsidian is a mcp server — MCP Agents Market links you directly to the official repo.

Is mcp-obsidian free?+

mcp-obsidian is an open-source project hosted on GitHub. Check the repository for its license and any usage requirements.

Related searches