Microsoft Todo

🚀 微軟待辦事項 MCP 服務

此MCP（模型上下文協議）服務允許您藉助AI助手與微軟待辦事項任務進行交互，為您的待辦事項管理提供更便捷的體驗。

🚀 快速開始

此MCP服務可讓您通過AI助手與微軟待辦事項任務交互。使用前需完成安裝和配置，下面為您詳細介紹。

✨ 主要特性

• 支持通過AI助手與微軟待辦事項任務交互。
• 提供便捷的命令行操作方式。

📦 安裝指南

1. 先決條件

• Node.js 16或更高版本
• npm
• 微軟賬戶
• 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 portal。
2. 登錄您的微軟賬戶。
3. 在左側菜單中，選擇“Azure Active Directory” > “應用程序註冊”。
4. 點擊“新建應用程序”按鈕，並填寫必要信息：
   • 名稱：輸入您的應用名稱（例如：My TodoMCP App）。
   • 支持的賬戶類型：選擇“我的組織的目錄中的賬戶”或“任何組織的目錄和來賓訪問”。
5. 填寫應用註冊詳細信息後，點擊“創建”。

4. 配置

在您克隆的倉庫中創建一個.env文件，並添加以下內容：

CLIENT_ID=your_client_id
CLIENT_SECRET=your_client_secret
TENANT_ID=your_tenant_id

將 your_client_id、your_client_secret 和 your_tenant_id 替換為您在Azure應用註冊中獲得的相應值。

5. 使用說明

安裝完成後，您需要先進行身份驗證：

npm run login

遵循提示輸入您的微軟賬戶憑據。成功登錄後，您可以使用以下命令列出所有可用命令：

npm run list-commands

🔧 技術細節

限制

• API要求正確的身份驗證和權限
• 根據微軟的政策可能會有速率限制

故障排除

身份驗證問題

• "MailboxNotEnabledForRESTAPI" 錯誤：此錯誤通常表示您使用的是個人微軟賬戶。Microsoft待辦事項API通過Graph API對個人賬戶的訪問權限有限。
• 令牌獲取失敗：請確保您的.env文件中的CLIENT_ID、CLIENT_SECRET和TENANT_ID是正確的。
• 權限問題：請確保您已經在Azure應用註冊中授予了所需的權限，並且已同意組織管理員提供的行政支持。

賬戶類型問題

• 工作/學校賬戶：這些通常最適合使用待辦事項API。請使用TENANT_ID=organizations或您的具體租戶ID。
• 個人賬戶：如果必須使用個人賬戶，請嘗試TENANT_ID=consumers或TENANT_ID=common。

檢查身份驗證狀態

您可以通過以下命令檢查身份驗證狀態：

cat tokens.json | grep expiresAt

要將時間戳轉換為可讀日期：

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