Obsidian Todos MCP Server

黑曜石Todos MCP服务器

模型上下文协议（MCP）服务器，通过本地REST API为AI助手提供对黑社会todo的直接访问。

特性

• 🔍 全部列出 -从您的保管库中获取所有未完成的待办事项
• ➕ 添加所有 -在今天的每日笔记中创建新的待办事项
• ✏️ 更新待办事项 -修改现有待办事项或将其标记为完成
• 📊 获取统计数据 -按文件查看待办事项统计信息

先决条件

1. 黑曜石 已安装并启用以下插件：

- 本地REST API - 数据视图 - Todos REST API（此插件）

1. Node.js 18+已安装

安装

来自npm（即将推出）

npm install -g obsidian-todos-mcp-server

来源

cd mcp-server
npm install
npm run build

配置

环境变量

• OBSIDIAN_API_URL -REST API的基本URL（默认值： http://localhost:27124)
• OBSIDIAN_API_KEY -API密钥（如果已启用身份验证）

Claude桌面配置

添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "obsidian-todos": {
      "command": "npx",
      "args": ["-y", "obsidian-todos-mcp-server"],
      "env": {
        "OBSIDIAN_API_URL": "http://localhost:27124"
      }
    }
  }
}

或者在npm链接后使用直接的二进制名称：

{
  "mcpServers": {
    "obsidian-todos": {
      "command": "obsidian-todos-mcp",
      "env": {
        "OBSIDIAN_API_URL": "http://localhost:27124"
      }
    }
  }
}

或者，如果从源代码运行：

{
  "mcpServers": {
    "obsidian-todos": {
      "command": "node",
      "args": ["/path/to/obsidian-todos-api/mcp-server/dist/index.js"],
      "env": {
        "OBSIDIAN_API_URL": "http://localhost:27124"
      }
    }
  }
}

可用工具

list_todos

列出黑曜石金库中所有未完成的待办事项。

例子：

// No parameters needed
await use_mcp_tool({
  server_name: "obsidian-todos",
  tool_name: "list_todos",
  arguments: {}
});

add_todo

在今天的每日笔记中添加一个新的待办事项。

参数：

• text （string，必填）-todo文本

例子：

await use_mcp_tool({
  server_name: "obsidian-todos",
  tool_name: "add_todo",
  arguments: {
    text: "Review pull requests"
  }
});

update_todo

更新现有待办事项（标记完成、更改文本等）。

参数：

• file （string，必填）-包含todo的文件的路径
• line （number，必填）-待办事项的行号（0索引）
• text （字符串，可选）-待办事项的新文本
• completed （布尔值，可选）-标记为完整/不完整

例子：

await use_mcp_tool({
  server_name: "obsidian-todos",
  tool_name: "update_todo",
  arguments: {
    file: "Daily/2025-10-31.md",
    line: 5,
    completed: true
  }
});

get_todo_stats

获取您待办事项的统计数据。

例子：

await use_mcp_tool({
  server_name: "obsidian-todos",
  tool_name: "get_todo_stats",
  arguments: {}
});

发展

# Watch mode for development
npm run dev

# Build for production
npm run build

# Test the server
echo '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | node dist/index.js

故障排除

连接问题

1. 确保Obsidian本地REST API正在运行
2. 检查API URL是否正确（默认值： http://localhost:27124)
3. 验证Todos REST API插件是否已在Obsidian中启用

身份验证错误

如果在本地REST API中启用了身份验证：

1. 设置 OBSIDIAN_API_KEY 环境变量
2. 或者使用API键更新您的Claude Desktop配置

许可证

麻省理工学院