ms-todo-oauth

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

⚠️This is a oauth based script. It contains a generated Azure Client ID and Secret ID

IF YOU WORRIED ABOUT YOUR PRIVACY, CONSIDER REPLACING THEM TO YOUR OWN IN scripts\ms-todo-oauth.py. Just search for values below:

client_id="ca6ec244……

client_secret="TwQ8Q……

✨ Features

• ✅ Full Task Management: Create, complete, delete, and search tasks
• 🗂️ List Organization: Create and manage multiple task lists
• ⏰ Rich Task Options: Priorities, due dates, reminders, descriptions, tags
• 🔄 Recurring Tasks: Daily, weekly, monthly patterns with custom intervals
• 📊 Multiple Views: Today, overdue, pending, statistics
• 🔍 Powerful Search: Find tasks across all lists
• 💾 Data Export: Export all tasks to JSON
• 🧪 Fully Tested: 29 comprehensive automated tests
• 🌐 Unicode Support: Full support for Chinese characters and emojis

Prerequisites

1. Python >= 3.9 must be installed
2. Working directory: All commands MUST be run from the root of this skill (the directory containing this SKILL.md file)
3. Network access: Requires internet access to Microsoft Graph API endpoints
4. Microsoft Account: Personal Microsoft account (Hotmail, Outlook.com) or work/school account
5. Authentication: First-time use requires OAuth2 login via browser. See Authentication section
   • Token cache: ~/.mstodo_token_cache.json (persists across sessions, auto-refreshed)

Installation & Setup

First-Time Setup

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

# Navigate to skill directory
cd <path-to-ms-todo-oauth>

# Create a venv in the project (creates '.venv' folder)
python3 -m venv .venv
# Activate the venv choose based on platforms:
#- Bash/Zsh: 
source .venv/bin/activate
# - Fish: 
source .venv/bin/activate.fish
#  - Windows (PowerShell):
.venv\Scripts\Activate.ps1

pip install --upgrade pip
pip install -r requirements.txt

# Alternative (global python env, not recommended):
# pip install -r requirements.txt

Dependencies:

• msal (Microsoft Authentication Library) - Official Microsoft OAuth library
• requests - HTTP client for API calls
• Specified in requirements.txt

Environment Verification

After installation, verify the setup:

# If using native venv (activate as above):
python3 scripts/ms-todo-oauth.py --help

# Expected: Command help text should be displayed

Troubleshooting:

• If Python not found, install Python 3.9 or higher from https://python.org

Testing (Optional but Recommended)

Verify all functionality works correctly:

# Run comprehensive automated test suite (29 tests)
python3 test_ms_todo_oauth.py

# Expected: All tests pass (100% pass rate)

See Testing section for details.

Security Notes