mcpField
M
microsoft-todo

microsoft-todo

github.com/acedatacloudProductivity17179 installsUpdated today
Repository

About microsoft-todo

A command-line skill for managing Microsoft To Do through Microsoft Graph using curl and jq. It covers task-list and task operations, with guidance on authentication, permissions, and pagination.

Key features

  1. 01List task lists
  2. 02Retrieve open tasks
  3. 03Create tasks
  4. 04Use optional due dates and reminders
  5. 05Follow paginated results

Use cases

  1. 01Find a user's task lists
  2. 02Review unfinished tasks in a list
  3. 03Add a task with a due date
  4. 04Retrieve all tasks across result pages

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/acedatacloud/skills --skill microsoft-todo

After installing, type/microsoft-todoin Claude Code to confirm it loaded.

Details

From the project README

Drive Microsoft To Do via Microsoft Graph with curl + jq. The user's OAuth bearer token is in $MICROSOFT_TODO_TOKEN; every call needs Authorization: Bearer $MICROSOFT_TODO_TOKEN. Base URL: https://graph.microsoft.com/v1.0.

Failures are {"error":{"code","message"}} — show message verbatim. 401 means the token expired (re-install). 403/ErrorAccessDenied on a write means the user only granted Tasks.Read → ask them to re-connect with read+write.

G="https://graph.microsoft.com/v1.0"; AUTH="Authorization: Bearer $MICROSOFT_TODO_TOKEN"
# Task lists
curl -sS -H "$AUTH" "$G/me/todo/lists" | jq '.value[] | {id, displayName, wellknownListName}'

Tasks

LIST="LIST_ID"
# Open tasks in a list (filter notStarted/inProgress; $top caps page size)
curl -sS -H "$AUTH" \
  "$G/me/todo/lists/$LIST/tasks?\$filter=status ne 'completed'&\$top=50" \
  | jq '.value[] | {id, title, status, due: .dueDateTime.dateTime}'

# Create (confirm first). dueDateTime/reminderDateTime are optional.
curl -sS -X POST -H "$AUTH" -H "Content-Type: application/json" \
  -d '{"title":"Follow up with Alex","dueDateTime":{"dateTime":"2026-06-30T17:00:00","timeZone":"UTC"}}' \
  "$G/me/todo/lists/$LIST/tasks" | jq '{id, title, status}'

# Complete: PATCH the task with {"status":"completed"}
curl -sS -X PATCH -H "$AUTH" -H "Content-Type: application/json" \
  -d '{"status":"completed"}' "$G/me/todo/lists/$LIST/tasks/TASK_ID" | jq '{title, status}'

Gotchas

  • OData params ($filter, $top, $select) need the $ escaped in the shell (\$filter) and URL-encoded spaces — quote the whole URL.
  • wellknownListName: "defaultList" is the user's default "Tasks" list — a good fallback when they don't name a list.
  • Pagination via @odata.nextLink; follow it for "all tasks".

Comments

Markdown supported