Features
Read-Only by Default
Starts with Tasks.Read so onboarding stays lightweight and tenant-friendly.
Shared Auth Story
Uses the same reusable Microsoft auth package as the rest of the Graph-backed toys.
WAM-First Windows Flow
Designed for a Windows shop first, with broker-backed sign-in and a tidy path to later portability.
Task-Focused Commands
Use list, add, complete, and remove without extra ceremony.
JSON Output
Switch to machine-readable output for automation while keeping a human-friendly interactive mode.
Toy Chest Shape
Python package layout, PowerShell wrapper, tests, and documentation that match the newer dev toys.
Installation
Quick Start
py -3 -m venv .venv
.\.venv\Scripts\python.exe -m pip install --upgrade pip
.\.venv\Scripts\python.exe -m pip install -e .[dev]
.\.venv\Scripts\python.exe -m pip install -e ..\midtown-org-scan\microsoft-authAuth Setup
$env:TODO_CLIENT_ID="your-client-id"
$env:TODO_TENANT_ID="your-tenant-id"
$env:TODO_SCOPES="Tasks.Read"
$env:TODO_AUTH_MODE="wam"
$env:TODO_ALLOW_BROKER="true"Daily Workflow
1
Authenticate once with the shared Microsoft auth setup.
→
2
Run todo list to scan tasks in interactive or JSON mode.
→
3
Opt into Tasks.ReadWrite later only if you want mutating commands.