MCP Obsidian Advanced

tokidoo/mcp-obsidian-advanced

一个高级Obsidian MCP服务器，通过Local REST API插件与Obsidian交互，使AI代理能深度理解知识库结构、链接和内容，提供文件操作、搜索、笔记管理和知识库分析等功能。

安装

uvx mcp-obsidian-advanced

客户端配置

{
  "mcpServers": {
    "mcp-obsidian-advanced": {
      "command": "uvx",
      "args": [
        "mcp-obsidian-advanced"
      ],
      "env": {
        "OBSIDIAN_API_KEY": "<OBSIDIAN_API_KEY>",
        "OBSIDIAN_VAULT_PATH": "<OBSIDIAN_VAULT_PATH>"
      }
    }
  }
}

环境变量

OBSIDIAN_API_KEYOBSIDIAN_VAULT_PATHOBSIDIAN_HOSTOBSIDIAN_PORT

作者: @tokidoo
分类: 笔记工具, 知识管理与记忆
更新于: 2026年10月6日

工具（22）

obsidian_list_files_in_dir
Lists all files and directories in a specific Obsidian directory
obsidian_batch_get_files
Return the contents and metadata of one or more notes (.md files) in your vault
obsidian_put_file
Create a new file in your vault or update the content of an existing one
obsidian_append_to_file
Append content to a new or existing file in the vault
obsidian_patch_file
Insert content into an existing note relative to a heading, block reference, or frontmatter field
obsidian_delete_file
Delete a file or directory from your vault
obsidian_simple_search
Simple search for documents matching a specified text query across all files in the vault
obsidian_complex_search
Complex search for documents using a JsonLogic query with support for 'glob' and 'regexp' pattern matching
obsidian_get_active_note
Get the content and metadata of the currently active note in Obsidian
obsidian_periodic_notes
Get current periodic note for the specified period (daily, weekly, monthly, quarterly, yearly)
obsidian_recent_periodic_notes
Get most recent periodic notes for the specified period type
obsidian_recent_changes
Get recently modified files in the vault
obsidian_understand_vault
Get a comprehensive understanding of the vault structure including directory tree and NetworkX graph of note connections
obsidian_open_files
Open one or more files in the vault in a new leaf
obsidian_execute_commands
Execute one or more commands in obsidian interface
OBSIDIAN_API_KEY
Obtain this by installing the Obsidian REST API plugin, and go into settings.
OBSIDIAN_VAULT_PATH
The absolute path to your vault must be set in order for tools (e.g. obsidian_understand_vault) to function properly.
OBSIDIAN_HOST
Could be changed in the Obsidian REST API plugin settings.
OBSIDIAN_PORT
Could be changed in the Obsidian REST API plugin settings.
INCLUDE_TOOLS
This variable controls which tools would be available for use.
obsidiantools_in_15_minutes_documentation.md
is a ipynb file that demonstrates use cases for obsidiantools.
obsidian_rest_api_documentation.yaml
is a yaml file that demonstrates use cases for the Obsidian REST API.