什么是 MS To Do Sync？

MS To Do Sync 是一个强大的命令行界面，旨在弥合本地开发环境与 Microsoft To Do 之间的差距。作为 Openclaw Skills 生态系统的一部分，它利用 Microsoft Graph API 提供任务和列表的完整 CRUD（创建、读取、更新、删除）功能。此技能对于需要不离开终端或编码会话即可跟踪生产力、管理提醒和组织工作流程的开发人员和 AI 代理特别有用。

通过提供与 Microsoft 任务管理基础架构交互的流线型方式，此工具可确保您的待办事项列表在所有设备上保持同步，同时允许编程访问。无论您是在管理复杂的项目里程碑还是简单的日常琐事，此集成都能将 Microsoft Graph 的强大功能带入您的 Openclaw Skills 设置中。

下载入口:https://github.com/openclaw/skills/tree/main/skills/xiaoski/ms-todo-sync

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

2. 手动安装

将技能文件夹复制到以下位置之一

优先级：工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

MS To Do Sync 应用场景

• 在开发周期中，通过 AI 驱动的编码代理自动创建任务。
• 将本地项目 TODO 与集中式 Microsoft 帐户同步，实现跨设备可见性。
• 通过终端命令管理每日日程、逾期警报和提醒。
• 将任务数据导出为 JSON，以便进行个人生产力分析或存档备份。
• 使用 Openclaw Skills 逻辑，智能地将工作组织到特定列表中，如工作、个人或购物。

1. 初始化环境并验证 Python 3.9+ 和 uv 包管理器等依赖项。
2. 执行 login get 命令，从 Microsoft 获取唯一的设备验证码。
3. 通过官方 Microsoft 设备登录门户，使用 Web 浏览器进行安全身份验证。
4. 通过 login verify 命令完成安全握手，并在本地缓存加密的身份验证令牌。
5. 使用统一的 CLI 脚本与任务和列表进行交互，该脚本将命令转换为 Openclaw Skills 框架内的 Microsoft Graph API 请求。

MS To Do Sync 配置指南

前提条件

• Python >= 3.9
• 已安装 uv 包管理器 (pip install uv)

安装步骤

# 进入技能目录
cd ms-todo-sync

# 使用 uv 安装依赖项
uv sync

# 发起身份验证
uv run scripts/ms-todo-sync.py login get

# 完成浏览器登录后，验证会话：
uv run scripts/ms-todo-sync.py login verify

MS To Do Sync 数据架构与分类体系

该技能主要通过 Microsoft Graph API 管理数据，但会保持身份验证和数据可移植性的本地状态。以下是元数据和文件组织：

name: ms-todo-sync description: > A CLI skill to manage Microsoft To Do tasks via Microsoft Graph API. Supports listing, creating, completing, deleting, searching tasks and lists, viewing overdue/today/pending tasks, and exporting data. metadata: version: 1.0.2 author: xiaoski@qq.com license: MIT License tags: [productivity, task-management, microsoft-todo, cli] category: productivity

ms-todo-sync

A Microsoft To Do command-line client for managing tasks and lists via Microsoft Graph API.

Prerequisites

1. Python >= 3.9 must be installed.
2. uv (Python package manager) must be installed. Install via pip install uv or see https://docs.astral.sh/uv/.
3. Working directory: All commands MUST be run from the root of this skill (the directory containing this SKILL.md file).
4. Network access: Requires internet access to Microsoft Graph API endpoints.
5. Authentication: First-time use requires interactive login via browser. See Authentication section.
   • Token cache: ~/.mstodo_token_cache.json (persists across sessions, auto-refreshed)
   • Device flow cache: ~/.mstodo_device_flow.json (temporary)

Installation & Setup

First-Time Setup

Before using this skill for the first time, dependencies must be installed:

# Navigate to skill directory
cd 

# Install dependencies using uv (recommended - creates isolated environment)
uv sync

# Alternative: Install dependencies with pip (uses global/active Python environment)
pip install -r requirements.txt

Dependencies:

• Requires msal (Microsoft Authentication Library) and requests
• Specified in requirements.txt
• uv creates an isolated virtual environment to avoid conflicts

Environment Verification

After installation, verify the setup:

# Check if uv can find the script
uv run scripts/ms-todo-sync.py --help

# Expected: Command help text should be displayed

Troubleshooting:

• If uv: command not found, install uv: pip install uv
• If Python not found, install Python 3.9 or higher from https://python.org
• If script fails with import errors, ensure dependencies are installed: uv sync or pip install -r requirements.txt

Security Notes

• Uses official Microsoft Graph API via Microsoft's msal library
• All code is plain Python (.py files), readable and auditable
• Tokens stored locally in ~/.mstodo_token_cache.json
• All API calls go directly to Microsoft endpoints

Command Reference

All commands follow this pattern:

uv run scripts/ms-todo-sync.py [GLOBAL_OPTIONS]  [COMMAND_OPTIONS]

Global Options

?? Common mistake: Global options MUST come before the subcommand.

• ? uv run scripts/ms-todo-sync.py -v lists
• ? uv run scripts/ms-todo-sync.py --debug add "Task"
• ? uv run scripts/ms-todo-sync.py lists -v

Authentication

Authentication uses a two-step device code flow designed for non-interactive/agent environments.

login get — Get verification code

uv run scripts/ms-todo-sync.py login get

Output example:

? Verification code generated

Please visit the following link to log in:
https://microsoft.com/devicelogin

Enter verification code: ABC123XYZ

Verify with command: ms-todo-sync.py login verify

Agent behavior: Present the URL and verification code to the user. Wait for the user to confirm they have completed the browser login before proceeding.

login verify — Complete login

uv run scripts/ms-todo-sync.py login verify

Output on success:

? Authentication successful! Login information saved, you will be logged in automatically next time.

Output on failure:

? Authentication failed: 

?? This command blocks until Microsoft's server confirms the user completed browser authentication. Do NOT run this until the user confirms they have completed the browser step.

Exit code: 0 on success, 1 on failure.

logout — Clear saved login

uv run scripts/ms-todo-sync.py logout

Only use when the user explicitly asks to switch accounts or clear login data. Under normal circumstances, the token is cached and login is automatic.

List Management

lists — List all task lists

uv run scripts/ms-todo-sync.py lists
uv run scripts/ms-todo-sync.py -v lists  # with IDs and dates

Output example:

?? Task Lists (3 total):

1. Tasks
2. Work
3. Shopping

create-list — Create a new list

uv run scripts/ms-todo-sync.py create-list ""

Output: ? List created:

delete-list — Delete a list

uv run scripts/ms-todo-sync.py delete-list "" [-y]

?? This is a destructive operation. Without -y, the command will prompt for confirmation. Consider asking the user before deleting important lists.

Output: ? List deleted:

Task Operations

add — Add a new task

uv run scripts/ms-todo-sync.py add "