MarkusPfundstein/mcp-obsidian
Free通过 REST API 与 Obsidian 交互。
FreeFree tier
Inputs: textOutputs: text
About MarkusPfundstein/mcp-obsidian
MarkusPfundstein/mcp-obsidian is an open-source MCP (Model Context Protocol) server that enables AI assistants like Claude to interact with an Obsidian vault through the Obsidian Local REST API community plugin. It provides a set of tools for file and content operations, such as listing files, reading note contents, searching across notes, inserting or appending content, and deleting files. The server is configured via environment variables, requiring the Obsidian REST API key. It is designed for users who want to leverage AI to manage, query, and manipulate their Obsidian notes programmatically.
Key Features
List all files and directories in the vault root or a specific directory
Retrieve the full content of a single file
Search across all files for documents matching a text query
Insert content into an existing note relative to a heading, block reference, or frontmatter field
Append content to a new or existing file
Delete a file or directory from the vault
Pros & Cons
Pros
- Open-source and free to use
- Provides direct, programmatic access to Obsidian vault content
- Supports a range of file operations (read, write, search, delete)
- Integrates with AI assistants via the MCP protocol
- Simple configuration with environment variables
Cons
- Requires the Obsidian Local REST API community plugin to be installed and configured
- Depends on the Obsidian REST API key being set correctly
- Limited to operations exposed by the REST API plugin; not all Obsidian features may be accessible
- Free tier usage limits (if any) depend on the AI assistant platform, not the server itself
Best For
Summarizing recent meeting notes and saving the summary as a new noteSearching for all notes mentioning a specific topic (e.g., 'Azure CosmosDb') and explaining the contextRetrieving the content of the latest architecture note and summarizing itAutomating note organization by appending content to daily journals or project filesInserting templated content into notes at specific locations (e.g., under a heading)
FAQ
What is required to use mcp-obsidian?
You need an Obsidian vault with the Local REST API community plugin installed and configured, and an API key. The server is run via uvx or Python, and the API key is set as an environment variable.
Can mcp-obsidian create new notes?
Based on available information, the server includes an 'append_content' tool that can append content to a new or existing file, which effectively allows creating new notes.
Does mcp-obsidian support searching within notes?
Yes, it provides a 'search' tool that searches for documents matching a specified text query across all files in the vault.
Is mcp-obsidian free to use?
The server itself is open-source and free. Usage costs may apply depending on the AI assistant platform (e.g., Claude) that connects to it.
Can I delete files using mcp-obsidian?
Yes, the server includes a 'delete_file' tool that can delete a file or directory from your vault.
How do I configure the Obsidian REST API key?
The API key is set as an environment variable named OBSIDIAN_API_KEY. It can be added to the MCP server configuration or set in the environment before running the server.