Microsoft To Do

Microsoft To Do 命令行工具

Manage tasks in Microsoft To Do using the todo command.

References references/设置up.md (Azure 应用 registration + OAuth configuration) Prerequisites todo 命令行工具 安装ed (pip 安装 microsoft-todo-命令行工具) Microsoft Azure 应用 registered (see references/设置up.md) 凭证s 配置d at ~/.config/microsoft-todo-命令行工具/keys.yml First 运行 completes OAuth flow in browser Commands Tasks # 列出 tasks todo tasks --json # Default 列出 todo tasks Work --json # Specific 列出 todo tasks --due-today --json # Due today todo tasks --overdue --json # Past due todo tasks --导入ant --json # High priority todo tasks --completed --json # Done tasks todo tasks --all --json # Everything

# 创建 task todo new "Task name" --json # Basic todo new "Task" -l Work --json # In specific 列出 todo new "Task" -d tomorrow --json # With due date todo new "Task" -r 2h --json # With reminder todo new "Task" -d mon -r 9am --json # Due Monday, remind 9am todo new "Task" -I --json # 导入ant todo new "Task" -R dAIly --json # Recurring dAIly todo new "Task" -R weekly:mon,fri --json # Specific days todo new "Task" -S "Step 1" -S "Step 2" --json # With subtasks todo new "Task" -N "Note content" --json # With note

# 更新 task todo 更新 "Task" --title "New" --json todo 更新 "Task" -d friday -I --json

# Complete/Uncomplete todo complete "Task" --json todo complete 0 1 2 --json # Batch by 索引 todo uncomplete "Task" --json

# 删除 todo rm "Task" -y --json

Subtasks (Steps) todo new-step "Task" "Step text" --json todo 列出-steps "Task" --json todo complete-step "Task" "Step" --json todo uncomplete-step "Task" "Step" --json todo rm-step "Task" 0 --json

Notes todo note "Task" "Note content" todo show-note "Task" todo clear-note "Task"

列出s todo 列出s --json todo new-列出 "Project X" --json todo rename-列出 "Old" "New" --json todo rm-列出 "Project X" -y --json

Task Identification Method Stability Use Case --id "AAMk..." Stable 自动化, scripts 索引 (0, 1) Unstable Interactive only Name ("Task") Unstable Unique names only

Use ID for multi-step operations:

ID=$(todo new "Task" -l Work --json | jq -r '.id') todo complete --id "$ID" -l Work --json

Date & Time 格式化s Type Examples Relative 1h, 30m, 2d, 1h30m Time 9:30, 9am, 17:00, 5:30pm Days tomorrow, monday, fri Date 2026-12-31, 31.12.2026 Keywords morning (7:00), evening (18:00) Recurrence Patterns Pattern Description dAIly Every day weekly Every week monthly Every month yearly Every year weekdays Monday to Friday weekly:mon,wed,fri Specific days every 2 days Custom interval Aliases Alias Command t tasks n new c complete d rm sn show-note cn clear-note Notes Always use --json for all commands to 获取 structured 输出 Always use -y with rm commands to skip confirmation Use --id with -l 列出Name for 列出 上下文 First 运行 opens browser for OAuth authentication