Microsoft To Do MCP

此 MCP (模型上下文协议) 服务允许您使用 AI 助手与 Microsoft To Do 任务进行交互。

设置说明

1. 前提条件

• Node.js 16 或更高版本
• npm
• 一个 Microsoft 帐户
• Azure 应用注册（参见下面的设置）

2. 安装

安装此工具分为两个部分：

1. 安装包
2. 设置身份验证（需要克隆存储库）

步骤 1：安装包

npm install -g @jhirono/todomcp

步骤 2：设置身份验证

即使您全局安装了该包，您仍然需要克隆存储库才能完成身份验证过程：

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

3. Azure 应用注册

1. 转到 Azure 门户
2. 导航到“应用注册”并创建一个新的注册
3. 命名您的应用程序（例如，“To Do MCP”）
4. 对于“支持的帐户类型”，根据您的需要选择以下选项之一：
   • 仅限此组织目录中的帐户（单租户） - 供单个组织内部使用
   • 任何组织目录中的帐户（任何 Azure AD 目录 - 多租户） - 供多个组织使用
   • 任何组织目录中的帐户和个人 Microsoft 帐户 - 供工作帐户和个人帐户使用
5. 将重定向 URI 设置为 http://localhost:3000/callback
6. 创建应用后，转到“证书和机密”并创建一个新的客户端机密
7. 转到“API 权限”并添加以下权限：
   • Microsoft Graph > 委派的权限：
     • Tasks.Read
     • Tasks.ReadWrite
     • User.Read
8. 单击“授予管理员同意”以获取这些权限

4. 配置

在根目录中创建一个 .env 文件，其中包含以下信息：

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

TENANT_ID 选项：

• organizations - 适用于多租户组织帐户（如果未指定，则为默认值）
• consumers - 仅适用于个人 Microsoft 帐户
• common - 适用于组织和个人帐户
• your-specific-tenant-id - 适用于单租户配置

示例：

# 适用于多租户组织帐户（默认）
TENANT_ID=organizations

# 适用于个人 Microsoft 帐户
TENANT_ID=consumers

# 适用于组织和个人帐户
TENANT_ID=common

# 适用于特定组织租户
TENANT_ID=00000000-0000-0000-0000-000000000000

用法

完整工作流程

1. 验证身份以获取令牌（必须从克隆的存储库完成）

   npm run auth
   

   这将打开一个浏览器窗口，供您使用 Microsoft 验证身份并创建一个 tokens.json 文件。

2. 创建 MCP 配置文件（必须从克隆的存储库完成）

   npm run create-config
   

   这将创建一个包含您的身份验证令牌的 mcp.json 文件。

3. 设置全局 MCP 配置

   # 将 mcp.json 文件复制到您的全局 Cursor 配置目录
   cp mcp.json ~/.cursor/mcp-servers.json
   

   这使得 Microsoft To Do MCP 在您的所有 Cursor 项目中可用。

4. 开始与您的 AI 助手一起使用

   • 在 Cursor 中，您现在可以直接在任何项目中使用 Microsoft To Do 命令
   • 尝试 auth status 或 list up todos 等命令以开始使用

Claude Desktop 配置文件位于：

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

可用工具

• auth-status: 检查您的身份验证状态
• get-task-lists: 获取您的所有 To Do 任务列表
• 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: 删除清单项目

限制

• API 需要正确的身份验证和权限
• 速率限制可能根据 Microsoft 的策略适用

故障排除

身份验证问题

• "MailboxNotEnabledForRESTAPI" 错误: 这通常意味着您正在使用个人 Microsoft 帐户。 通过 Graph API，Microsoft To Do API 访问权限对于个人帐户受到限制。

• 令牌获取失败: 确保您的 .env 文件中的 CLIENT_ID、CLIENT_SECRET 和 TENANT_ID 正确。

• 权限问题: 确保您已在 Azure 应用注册中授予所需权限的管理员同意。

帐户类型问题

• 工作/学校帐户: 这些通常最适合 To Do API。 使用 TENANT_ID=organizations 或您的特定租户 ID。

• 个人帐户: 这些帐户对 To Do API 的访问权限有限。 如果您必须使用个人帐户，请尝试 TENANT_ID=consumers 或 TENANT_ID=common。

检查身份验证状态

您可以使用 auth-status 工具或通过检查令牌中的过期时间来检查您的身份验证状态：

cat tokens.json | grep expiresAt

要将时间戳转换为可读日期：

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