A cross-platform command-line interface to interact with Microsoft To Do, built using .NET 8.
| Platform | Status |
|---|---|
| CI | |
| CD |
If you just want to give it a spin, head over to releases. Download a release and extract to somewhere in your PATH, and run todo --help to get started.
# Clone the repository
git clone https://github.com/mehmetseckin/todo-cli.git
# Navigate into the source code folder
cd .\todo-cli\src
# Build the project
dotnet build
The application will automatically prompt you to sign in with your Microsoft account, and ask for your consent to access your data when needed.
# Run using dotnet run
dotnet run -p .\Todo.CLI -- --help
# Run from build output
.\src\publish\todo.exe --help
# Windows x64
dotnet publish src\Todo.CLI -c Release -r win-x64 -o .\src\publish
# macOS (Intel)
dotnet publish src\Todo.CLI -c Release -r osx-x64 -o .\src\publish
# macOS (Apple Silicon)
dotnet publish src\Todo.CLI -c Release -r osx-arm64 -o .\src\publish
# Linux x64
dotnet publish src\Todo.CLI -c Release -r linux-x64 -o .\src\publish
| Command | Description |
|---|---|
todo add item <subject> |
Add a new to-do item |
todo add list <name> |
Add a new to-do list |
todo list [options] |
List items |
todo complete <id> |
Mark an item as completed |
todo remove <id> |
Remove an item |
| Option | Description |
|---|---|
--list <name> |
Target a specific list |
--star |
Mark the item as important |
--due-date <date> |
Set a due date (yyyy-MM-dd or MM-dd) |
# Add an item with a due date
todo add item "Buy groceries" --due-date 2026-05-20
# Add an item with MM-dd format (current year is used)
todo add item "Doctor appointment" --due-date 06-15
# Add a starred item to a specific list
todo add item "Important report" --star --list Work
# List all tasks
todo list
# Mark a task as completed
todo complete <task-id>
# Remove a task
todo remove <task-id>
Work (3):
- Buy groceries - NotStarted (05-20)
✓ Completed task - Completed (2026-05-10)
- Important report - NotStarted
Interested? You are awesome. Feel free to fork, do your thing and send a PR! Everything is appreciated.
Be nice to people, give constructive feedback, and have fun!
This project is built using the following nuggets of awesomeness, and many more. Many thanks to the folks who are working on and maintaining these products.