Obsidian MCP Server

cyanheads/obsidian-mcp-server

一个基于TypeScript的MCP服务器，专为LLM与Obsidian知识库交互设计，提供文件操作、搜索系统和属性管理功能。

安装

bunx obsidian-mcp-server@latest

客户端配置

{
  "mcpServers": {
    "obsidian-mcp-server": {
      "command": "bunx",
      "args": [
        "obsidian-mcp-server@latest"
      ],
      "env": {
        "MCP_TRANSPORT_TYPE": "<MCP_TRANSPORT_TYPE>",
        "MCP_LOG_LEVEL": "<MCP_LOG_LEVEL>",
        "OBSIDIAN_API_KEY": "<OBSIDIAN_API_KEY>"
      }
    }
  }
}

环境变量

MCP_TRANSPORT_TYPEMCP_LOG_LEVELOBSIDIAN_API_KEY

GitHub 星标: 65
作者: @cyanheads
分类: 笔记工具, 知识管理与记忆
许可证: Apache-2.0
更新于: 2026年10月6日

工具（22）

obsidian_get_note
Read a note as raw content, full structured form, document map, or a single section
obsidian_list_notes
List notes and folders under a vault path, recursively, with extension and name filters
obsidian_list_tags
List vault tags with usage counts, most-used first
obsidian_search_notes
Search by text, JSONLogic, or BM25-ranked Omnisearch when that plugin is reachable
obsidian_write_note
Create a note, replace one section, or overwrite a whole file with overwrite: true
obsidian_append_to_note
Append to a note (creating it if missing) or to one heading, block, or frontmatter field
obsidian_patch_note
Append, prepend, or replace against one heading, block reference, or frontmatter field
obsidian_replace_in_note
Literal or regex search-replace inside one note, body-only by default
obsidian_manage_frontmatter
Get, set, or delete one frontmatter key
obsidian_manage_tags
Add, remove, or list a note's tags in frontmatter, inline, or both
obsidian_delete_note
Permanently delete a note, optionally after the user confirms (OBSIDIAN_DELETE_ELICITATION)
obsidian_open_in_ui
Open a file in the Obsidian app, optionally in a new pane
obsidian_list_commands
List command-palette commands (opt-in via OBSIDIAN_ENABLE_COMMANDS)
obsidian_execute_command
Run a command-palette command by ID (opt-in via OBSIDIAN_ENABLE_COMMANDS)
target
is a vault path, the active file, or a periodic note (daily through yearly, optional date); format is content, full, document-map, or section, and full takes…
result.format
discriminates the payload; a section read that matches several headings returns the first and lists every full path in candidates
nameRegex
(≤256 chars) and minCount narrow the set, then tags are ranked by count and capped at limit (default 200, max 10000); hierarchical parents count (work/tasks…
result.mode
discriminates the payload; every mode reports totalCount and pages via nextCursor, and a text hit clipped to maxMatchesPerHit carries truncated and totalMatches
get
returns exists and value (null when absent); set and delete return the full frontmatter after the change, and a delete against unparseable YAML fails with…
add
remove report applied, skipped, and the resulting tags; list returns frontmatter, inline, and all
createdIfMissing
reports which branch ran
commandId
from obsidian_list_commands; returns executed: true, or fails with command_unknown for an unregistered ID