AI导哈

笔记与任务管理工具

Obsidian与MCP生产力设置指南，提供笔记记录、任务管理和自动化任务提取功能，适用于个人和团队的知识管理。

  • by barath-koottala
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 barath-koottala/obsidian-mcp

使用说明

黑曜石+MCP生产力设置指南

嘿！本指南将指导您使用黑曜石进行日常笔记和 一个MCP服务器，让Claude自动提取您的未完成任务。 大约需要15分钟。

第一步：安装黑曜石

macOS（Homebrew）：

brew install --cask obsidian

macOS（手动）： 下载自 黑曜石.md/下载 并拖动到 /Applications.

验证是否已安装：

open -a Obsidian

第二步：创建保险库

您有两个选择：仅本地或iCloud同步。

选项A-iCloud（推荐：自动同步到iPhone/iPad）

您的保管库将位于iCloud Drive中，因此它可以在所有Apple设备上同步。

  1. 打开Finder并确保iCloud Drive已启用：

    • System Settings > Apple Account > iCloud > iCloud Drive (ON)

  2. 创建vault文件夹：

    mkdir -p ~/Library/Mobile\ Documents/iCloud~md~obsidian/Documents/Notes

  3. 打开黑曜石> “将文件夹作为vault打开” >导航到：

    ~/Library/Mobile Documents/iCloud~md~obsidian/Documents/Notes

    提示： 在Finder对话框中，按 Cmd+Shift+G 并粘贴上面的路径。

选项B——仅限本地

  1. 选择您喜欢的任何文件夹，例如：

    mkdir -p ~/Documents/ObsidianVault

  2. 打开黑曜石> “将文件夹作为vault打开” >选择该文件夹。

步骤3：设置每日笔记模板

3.1创建Templates文件夹

  • 在Obsidian中，单击文件夹图标（左侧边栏）> 新建文件夹
  • 命名它： Templates

3.2创建模板文件

  • 内部 Templates/，创建一个名为的新笔记 “主注释”
  • 准确粘贴此内容：
{{date}} {{time}}

Status:

Tags:

#  Notes



# Meetings




# TODO
- [ ]

# Daily Reflection

#reflection

3.3告诉Obsidian你的模板在哪里

  1. 打开 设置 （左下角的齿轮图标）
  2. 在...之下 核心插件，确保 “模板” 已打开
  3. 点击“模板”旁边的齿轮图标并设置：
    • 模板文件夹位置： Templates

3.4启用每日笔记

  1. 设置> 核心插件 >打开开关 “每日笔记”
  2. 点击“每日笔记”旁边的齿轮并配置：
    • 日期格式： YYYY-MM-DD
    • 新文件位置： Farther/{{date:YYYY}}/{{date:MMMM}}
    • 模板文件位置： Templates/Main Note

3.5创建文件夹结构

在Obsidian中，创建以下文件夹：

  • Farther 在保险库根处
  • Farther/2026
  • 根据需要将月份文件夹放入其中（例如。 Farther/2026/February)

或从终端：

VAULT="<your-vault-path>"
mkdir -p "$VAULT/Farther/2026"/{January,February,March,April,May,June,July,August,September,October,November,December}

步骤4：日常工作流程

创建当天的笔记

  1. 开放式黑曜石
  2. 点击 日历图标 在左侧边栏中，这将创建今天的每日笔记
  3. 进入新备忘后，按 Cmd+T 并选择您的 “主注释” 模板
  4. 您的笔记现在已填充了模板部分，准备就绪

全天使用您的笔记

  • 备注部分 --记下要点、想法、任何出现的东西
  • 会议科 --记录会议笔记（请参阅下面的步骤5，从谷歌日历自动填充）
  • TODO部分 --使用复选框语法添加任务：
    - [ ] Send the quarterly report
- [ ] Review PR for auth service
  • 标记已完成的任务 通过单击复选框（或手动更改 [ ] 到 [x]):
    - [x] Send the quarterly report
  • 日常反思 --一天结束时，写一篇关于事情进展的简短反思

步骤5：从谷歌日历自动填充会议（可选）

这 谷歌日历和联系人查找 插件允许您直接拉取会议 从谷歌日历到黑曜石笔记——无需手动复制粘贴。

安装插件

  1. 在黑曜石，请访问 设置>社区插件
  2. 如果出现提示，请单击 “打开社区插件”
  3. 点击 浏览 并搜索 “谷歌查找”
  4. 点击 安装那么 启用

设置Google凭据

  1. 首选 谷歌云控制台
  2. 创建新项目（或使用现有项目）
  3. 启用 谷歌日历API 和 人民API
  4. 创建 OAuth 2.0凭据 （桌面应用程序类型）
  5. 在黑曜石，请访问 设置>谷歌查找 并输入您的客户端ID和客户端密码
  6. 点击 验证 并使用您的Google帐户登录

每天使用

  1. 打开你的日记，把光标放在 会议 部分
  2. 打开命令面板(Cmd+P)然后跑 “谷歌查找：插入谷歌日历事件”
  3. 将出现一个搜索模式——找到您的会议并选择它
  4. 该插件将事件详细信息（标题、时间、与会者）直接插入到您的笔记中
  5. 在下面添加您的会议笔记

这个插件还支持查找谷歌联系人——如果你想的话，这很有用 在写笔记的同时快速获取某人的信息。

步骤6：安装黑曜石MCP服务器

先决条件

  • Node.js 18+ --检查一下 node --version
  • 如果未安装： brew install node
  • 黑曜石v1.12+ （推荐）--启用CLI集成，以实现更快的搜索、任务解析和更强大的路径处理。如果CLI不可用，MCP将回退到直接文件访问。

启用Obsidian CLI（推荐）

  1. 确保您使用的是Obsidian v1.12+(brew upgrade --cask obsidian 或从以下网址下载 黑曜石.md/下载)
  2. 打开黑曜石> 设置>常规>命令行界面 >启用它
  3. 按照提示在PATH中注册CLI
  4. 验证它是否有效： obsidian version

安装

  1. 克隆或复制 obsidian-mcp 文件夹到您的计算机：

    git clone <repo-url> ~/obsidian-mcp
cd ~/obsidian-mcp
npm install

  2. 将vault路径设置为环境变量（请参阅下面的步骤7）。您不再需要编辑源代码——vault路径已在Claude code MCP配置中配置。

  3. 测试服务器是否启动：

    npm start

    它应该没有错误地开始。按 Ctrl+C 停止。 如果检测到Obsidian CLI，您将看到： [obsidian-mcp] CLI detected at: ...

步骤7：将MCP添加到Claude代码中

打开 ~/.claude.json 在文本编辑器中。查找 "mcpServers" key（如果不存在，则添加）并添加 obsidian-vault 条目：

{
  "mcpServers": {
    "obsidian-vault": {
      "command": "node",
      "args": ["/full/path/to/obsidian-mcp/obsidian-mcp-server.js"],
      "env": {
        "OBSIDIAN_VAULT_ROOT": "/Users/<your-username>/Library/Mobile Documents/iCloud~md~obsidian/Documents/Notes"
      }
    }
  }
}

替换：

  • /full/path/to/ 使用克隆存储库的实际路径
  • OBSIDIAN_VAULT_ROOT 使用您的保险库的绝对路径：
    • Icloud： /Users/<your-username>/Library/Mobile Documents/iCloud~md~obsidian/Documents/Notes
    • 当地： /Users/<your-username>/Documents/ObsidianVault

可选环境变量：

变量 描述
OBSIDIAN_VAULT_ROOT 黑曜石保险库的绝对路径（fs回退所需）
OBSIDIAN_CLI_PATH 自定义路径 obsidian CLI二进制文件（如果在PATH中，则自动检测）
OBSIDIAN_VAULT_NAME 多保险库设置的保险库名称（传递为 vault=<name> 到CLI）

注： 如果 mcpServers 已经有其他条目，只需添加 "obsidian-vault" 把它们挡在一边——不要替换整个对象。

保存后重新启动Claude Code。

步骤8：使用MCP完成未完成的任务

连接后，您可以问Claude以下问题：

你问什么 它做什么
“我本周未完成的任务是什么？” 从本周的笔记中提取所有未检查的任务
“显示上个月我尚未完成的所有任务” 汇总上个月未完成的任务
“我上周完成了什么？” 显示上周完成的所有任务
“生成上周的任务滚动摘要” 创建结转内容的摘要
“将我的线性工单和结转任务写入今天的笔记” 自动填充您的TODO部分

MCP读取您的每日笔记，解析所有内容 - [ ] 和 - [x] 复选框， 并让你清楚地了解哪些问题仍未解决。

快速参考：任务语法

格式 示例
任务未完成 - [ ] Review the budget proposal
已完成任务 - [x] Review the budget proposal
带时间戳 - [x] Review the budget proposal ✅ 2026-02-24
子任务 - [ ] Check page 3 numbers

MCP理解所有这些格式。

故障排除

“未在正确文件夹中创建日记”

  • 检查“设置”>“每日笔记”>“新文件位置与文件夹结构匹配” （例如。， Farther/{{date:YYYY}}/{{date:MMMM}})

“Cmd+T不显示模板”

  • 确保在“设置”>“核心插件”中启用了模板核心插件
  • 确保模板文件夹位置设置为 Templates

“MCP找不到我的笔记”

  • 验证 VAULT_ROOT 在 obsidian-mcp-server.js 指向您的保险库
  • 验证 WORKING_DIR 匹配您的顶级文件夹名称
  • 确保你的日常笔记如下 YYYY-MM-DD.md 命名

“iCloud同步速度慢”

  • 这对于第一次同步是正常的。文件在后台同步。
  • 在iPhone/iPad上，打开“文件”应用程序>“iCloud Drive”以触发同步。

“谷歌查找插件无法进行身份验证”

  • 在插件设置中仔细检查您的客户端ID和客户端密码
  • 确保Google日历API和People API都在您的Google Cloud项目中启用
  • 尝试从“设置”>“谷歌查找”重新进行身份验证

相关 MCP