Microsoft To Do MCP

基本能力

产品定位

Microsoft To Do MCP 是一个连接 AI 助手与 Microsoft To Do 任务的中间件服务，旨在提高任务管理的效率和自动化程度。

核心功能

• 任务列表管理：获取、创建、更新、删除任务列表
• 任务管理：获取、创建、更新、删除任务
• 检查项管理：获取、创建、更新、删除检查项
• 认证状态检查

适用场景

• 个人任务管理自动化
• 团队协作中的任务分配和跟踪
• 与 AI 助手集成的智能任务管理

工具列表

• auth-status: 检查认证状态
• get-task-lists: 获取所有任务列表
• create-task-list: 创建新任务列表
• update-task-list: 更新现有任务列表
• delete-task-list: 删除任务列表
• get-tasks: 获取列表中的所有任务
• create-task: 创建新任务
• update-task: 更新现有任务
• delete-task: 删除任务
• get-checklist-items: 获取任务的检查项
• create-checklist-item: 创建检查项
• update-checklist-item: 更新检查项
• delete-checklist-item: 删除检查项

常见问题解答

1. 认证问题
2. "MailboxNotEnabledForRESTAPI"错误：通常是因为使用了个人 Microsoft 账户
3. 令牌获取失败：检查 .env 文件中的 CLIENT_ID, CLIENT_SECRET 和 TENANT_ID 是否正确

4. 权限问题：确保在 Azure 应用注册中授予了所需权限的管理员同意

5. 账户类型问题

6. 工作/学校账户：最适合使用 To Do API，建议使用 TENANT_ID=organizations 或特定租户 ID
7. 个人账户：对 To Do API 的访问有限，建议使用 TENANT_ID=consumers 或 TENANT_ID=common

使用教程

使用依赖

• Node.js 16 或更高版本
• npm
• Microsoft 账户
• Azure 应用注册

安装教程

1. 安装包

npm install -g @jhirono/todomcp

1. 设置认证（需要克隆仓库）

git clone https://github.com/jhirono/todoMCP.git
cd todoMCP
npm install

1. Azure 应用注册
2. 创建新应用注册
3. 设置重定向 URI 为 http://localhost:3000/callback
4. 创建客户端密钥
5. 添加 API 权限：Tasks.Read, Tasks.ReadWrite, User.Read

6. 授予管理员同意

7. 配置 创建 .env 文件，包含以下信息：

CLIENT_ID=your_client_id
CLIENT_SECRET=your_client_secret
TENANT_ID=your_tenant_setting
REDIRECT_URI=http://localhost:3000/callback

调试方式

1. 认证获取令牌

npm run auth

1. 创建 MCP 配置文件

npm run create-config

1. 设置全局 MCP 配置

cp mcp.json ~/.cursor/mcp-servers.json

1. 检查认证状态

cat tokens.json | grep expiresAt

1. 转换时间戳为可读日期

date -r $(echo "$(cat tokens.json | grep expiresAt | cut -d ":" -f2 | cut -d "," -f1) / 1000" | bc)

许可证

None