Skip to main content
skill CX Codex

microsoft-todo — Claude Code skill: Microsoft To Do tasks via Graph

Gives the agent a way to read and change Microsoft To Do lists and tasks through Microsoft Graph v1.0, with curl requests parsed by jq.

Apache-2.0 187 installs ★ 17 updated 2026-10-25

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add AceDataCloud/Skills --skill microsoft-todo -a claude-code
Open on GitHub

What microsoft-todo does

The skill puts Microsoft To Do within reach of the agent. Every operation is a plain curl call to https://graph.microsoft.com/v1.0, and the reply goes through jq, so nothing extra needs installing. Your OAuth token lives in $MICROSOFT_TODO_TOKEN and rides along in an Authorization: Bearer header.

Day-to-day moves are covered: listing task lists with id and displayName, fetching unfinished items with a status filter and a page cap, creating a task with a due date or reminder, marking one done by patching status to completed. When you don't name a list, the one flagged wellknownListName: defaultList is used. Writes get confirmed with you first.

What the agent can actually do depends on consent. A read-only token makes every write fail with 403, and a stale token returns 401, so you reconnect. OData parameters like $filter need the dollar sign escaped in the shell (\$filter) and the URL wrapped in quotes, or the ampersand cuts the command in half.

What it helps with

  • see every task list in the account
  • pull overdue items before a standup
  • add a task with a due date from chat
  • close a task without opening the To Do app
  • follow @odata.nextLink to gather the whole task list

Example prompts for the agent

  • Show my Microsoft To Do lists
  • Add “Follow up with Alex” to my Tasks list, due 2026-06-30
  • What's still open this week? Mark the finished ones complete.

How to install microsoft-todo

1Skills CLI (Vercel)

npx skills add AceDataCloud/Skills --skill microsoft-todo -a claude-code

2Manually: put the files in place

~/.claude/skills/microsoft-todo/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/microsoft-todo/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about microsoft-todo

How do I install microsoft-todo in Claude Code?

Run npx skills add AceDataCloud/Skills --skill microsoft-todo -a claude-code. The skill then sits at ~/.claude/skills/microsoft-todo/SKILL.md.

What does microsoft-todo do?

It reads and updates Microsoft To Do lists and tasks over Microsoft Graph v1.0: shows lists, creates tasks with due dates, closes them. The work happens in curl and jq rather than a client library.

Which permissions does microsoft-todo need?

Tasks.ReadWrite if the agent should change anything, or Tasks.Read for read-only use. Under read-only consent every write comes back 403, so reconnect with write access.

Source text

SKILL.md · Apache-2.0
---
name: microsoft-todo
description: Read and manage Microsoft To Do task lists and tasks via Microsoft Graph v1.0. Use when the user mentions Microsoft To Do, their Outlook tasks, todo / pending items, due dates or reminders, adding or completing a task, or organising task lists.
when_to_use: |
  Trigger when the user wants to inspect or manage Microsoft To Do —
  list task lists, surface pending / overdue items, add todos, mark
  complete, or update / delete tasks. The connector grants
  `Tasks.ReadWrite` (or `Tasks.Read` if the user chose read-only) —
  confirm before destructive writes.
connections: [microsoft/todo]
allowed_tools: [Bash]
license: Apache-2.0
metadata:
  author: acedatacloud
  version: "1.0"
---

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.

```bash
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

```bash
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".

© acedatacloud · Apache-2.0 · AceDataCloud/Skills

Similar skills

All skills for Notes, tasks and projects →

From the same set67

The whole set →

Project sponsors

Companies that keep this analytics open