List Microsoft 365 groups the user belongs to (needed as the container when creating a plan). Requires the GroupMember.Read.All permission; otherwise use group IDs from planner_list_plans.

List Planner plans (projects) shared with the signed-in user, with their group IDs.

Create a Planner plan (project) in a Microsoft 365 group, optionally with initial buckets (e.g. ['To do', 'In progress', 'Done']).

Rename a Planner plan. plan_ref is the plan ID or exact title.

Permanently delete a Planner plan with ALL its buckets and tasks. Confirm with the user first.

List buckets (columns) in a Planner plan.

Create a bucket in a Planner plan.

Rename a bucket in a Planner plan.

Permanently delete a bucket and ALL tasks in it. Confirm with the user first.

List tasks in a Planner plan, optionally filtered by bucket, completion and assignment.

List Planner tasks assigned to the signed-in user across all plans.

Get a Planner task including description and checklist.

Create a Planner task. assignees: 'me', user object IDs, or emails. labels: label names defined on the plan. Dates: YYYY-MM-DD (local time).

Update a Planner task. Only supplied fields change. Empty string for due/start clears it. bucket_ref moves it to another bucket in the same plan. labels replaces the task's labels. check_items ticks existing checklist items (by ID or title). progress='completed' completes it.

Permanently delete a Planner task. Confirm with the user first.

List all Microsoft To Do task lists (projects) for the signed-in user.

Create a new Microsoft To Do task list (project).

Rename a To Do list. list_ref is the list ID or its exact name.

Permanently delete a To Do list AND all tasks in it. Confirm with the user first. The default 'Tasks' list cannot be deleted.

List tasks in a To Do list. list_ref is the list ID or exact name (e.g. 'Tasks').

Get one To Do task with notes and checklist items.

Create a task in a To Do list. Dates: YYYY-MM-DD or YYYY-MM-DDTHH:MM (local time). checklist adds sub-steps.

Update a To Do task. Only supplied fields change. Pass an empty string for a date to clear it. Set status='completed' to complete a task, 'notStarted' to reopen it.

Permanently delete a To Do task. Confirm with the user first.

Move a task to another To Do list (copies title, notes, dates, importance, status, categories and checklist, then deletes the original). The task gets a new ID.

Add a checklist (sub-step) item to a To Do task.

Rename and/or tick/untick a checklist item on a To Do task.

Delete a checklist item from a To Do task. Confirm with the user first.

Show which sign-in app and Microsoft 365 account are in use and whether a valid token is available.

Turn automatic sign-in on or off. When on (default), an expired Microsoft 365 session opens the browser sign-in automatically and the pending request continues afterwards.

Sign in to Microsoft 365. Opens the system browser on this computer for sign-in/MFA.

On first use, or when the user wants to switch, ASK THE USER which app to sign in with:

1. app='own' - their own Entra app registration. Needs client_id (GUID) and tenant (tenant ID or verified domain).

2. app='microsoft' - Microsoft-published 'Microsoft Graph Command Line Tools' app, no registration needed. tenant is optional (default 'organizations' = any work account); suggest pinning their domain to avoid signing in to the wrong (e.g. customer) tenant.

timezone: 'auto' (default - the user's Microsoft 365 time zone, else this computer's) or an IANA zone such as Australia/Sydney. Omit app to reuse the saved choice. Once a sign-in app is configured it can't be changed from chat (only re-signed into); the user changes it with todo-planner-mcp login in a terminal or in the extension settings.