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
npx skills add AceDataCloud/Skills --skill microsoft-todo -a claude-codeWhat 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.nextLinkto 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-code2Manually: put the files in place
~/.claude/skills/microsoft-todo/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/microsoft-todo/
1Skills CLI (Vercel)
npx skills add AceDataCloud/Skills --skill microsoft-todo -a codex2Manually: put the files in place
.agents/skills/microsoft-todo/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add AceDataCloud/Skills --skill microsoft-todo -a cursor2Manually: put the files in place
.cursor/skills/microsoft-todo/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install AceDataCloud/Skills skills/microsoft-todo2Manually: put the files in place
.github/skills/microsoft-todo/SKILL.md1Skills CLI (Vercel)
npx skills add AceDataCloud/Skills --skill microsoft-todo -a gemini-cli2Platform CLI
gemini skills install https://github.com/AceDataCloud/Skills --path skills/microsoft-todoManually: put the files in place
.devin/skills/microsoft-todo/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add AceDataCloud/Skills --skill microsoft-todo -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
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