Obsidian Tasks MCP Server

基本能力

产品定位

Obsidian Tasks MCP Server 是一个专门用于管理Obsidian笔记中任务的工具，支持通过AI辅助进行任务查询和管理。

核心功能

• 从Obsidian markdown文件中提取任务，兼容Obsidian Tasks插件格式
• 识别已完成和待处理的任务
• 访问任务元数据，包括：
• 状态（完成/未完成）
• 截止日期
• 计划日期
• 开始日期
• 创建日期
• 标签
• 优先级
• 重复规则

适用场景

• 个人任务管理
• 团队协作任务跟踪
• AI辅助的任务查询和管理

工具列表

1. list_all_tasks
2. 功能：从指定目录及其子目录中递归扫描所有markdown文件并提取任务
3. 输入参数：path（可选，要扫描的目录）

4. 返回：包含所有任务对象的JSON数组

5. query_tasks

6. 功能：使用Obsidian Tasks查询语法搜索任务
7. 输入参数：
   • path（可选，要扫描的目录）
   • query（必需，查询字符串）
8. 返回：匹配查询条件的任务对象JSON数组

常见问题解答

1. 支持的任务格式：
2. 任务语法：- [ ] 任务描述
3. 已完成任务：- [x] 任务描述
4. 日期标记：使用特定emoji表示不同类型日期
5. 优先级：使用特定emoji表示高、中、低优先级

使用教程

使用依赖

• Node.js环境

安装教程

1. 通过npm安装（推荐）：

npm install -g @jfim/obsidian-tasks-mcp

或直接使用npx运行（无需安装）：

npx @jfim/obsidian-tasks-mcp /path/to/obsidian/vault

1. 从源代码安装：

git clone https://github.com/jfim/obsidian-tasks-mcp.git
cd obsidian-tasks-mcp
npm install
npm run build

运行服务器

1. 使用npm包（推荐）：

obsidian-tasks-mcp /path/to/obsidian/vault

或使用npx：

npx @jfim/obsidian-tasks-mcp /path/to/obsidian/vault

1. 从源代码运行：

node dist/index.js /path/to/obsidian/vault

调试方式

1. 运行测试套件：

npm test

1. 与Claude集成配置示例：

{
  "mcpServers": {
    "obsidian-tasks": {
      "command": "npx",
      "args": [
        "@jfim/obsidian-tasks-mcp",
        "/path/to/obsidian/vault"
      ]
    }
  }
}

许可证

该项目遵循 None 开源许可条款。