A 5-minute quickstart for @thingsai/msft-todo-cli-mcp — a CLI-first Microsoft To Do management tool with an optional MCP server for AI agents.
- Node.js 20+ — download here
- A Microsoft account (personal or work/school)
- An Azure AD app registration — see Azure Setup for step-by-step instructions
npm install -g @thingsai/msft-todo-cli-mcpVerify the installation:
todo --versionSet your Azure AD client ID and run the interactive setup. A browser window will open for Microsoft login.
export TODO_MCP_CLIENT_ID="your-client-id"
todo setupDon't have a client ID yet? Follow the Azure Setup guide to create one.
Once authenticated, you're ready to manage your tasks:
# List all your To Do lists
todo lists
# View tasks in a specific list
todo tasks --list <list-id>
# Create a new task with a due date
todo tasks create --list <list-id> --title "Test task" --due 2026-04-20
# Mark a task as complete
todo tasks complete --list <list-id> --task <task-id>
# Get JSON output (useful for scripting and automation)
todo lists --jsonTip: Use
todo listsfirst to find the<list-id>you need, then pass it to other commands.
- Full CLI Reference — all commands and options
- MCP Server Setup — connect to AI agents via Model Context Protocol
- Azure Setup — register an Azure AD app if you haven't already
- Configuration — environment variables and advanced options