todo-planner-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@todo-planner-mcp create a Planner task to review the budget and assign it to Alex"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
todo-planner-mcp
Status: unmaintained. A working, live-tested proof of concept (all 38 tools passed against a real Microsoft 365 tenant, October 2026). It's no longer actively developed. Feel free to fork it; issues and pull requests may not get a response.
An MCP (Model Context Protocol) server that exposes Microsoft To Do and Microsoft Planner over the Microsoft Graph API with delegated auth, so an assistant (e.g. a PA skill) can read and write your personal tasks (To Do) and your assignable team tasks (Planner).
Why
The built-in Microsoft 365 connector is read-only and has no Tasks/Planner scope.
To Do = personal catch-all. Planner = shared, assignable, cross-plan work.
This server covers full CRUD on both, including assigning Planner tasks to other people.
Related MCP server: mcp-outlook-calendar
Requirements
Python 3.10+
A Microsoft Entra (Azure AD) app registration. Two supported modes:
With a client secret (confidential client, browser sign-in): add a Web platform redirect URI
http://localhost:8400/callback(or whateverTPM_REDIRECT_URIis).Without a secret (public client, device code): Authentication → Allow public client flows: Yes.
Delegated API permissions:
User.Read,User.ReadBasic.All(member names),Tasks.ReadWrite(To Do + Planner tasks),Group.Read.All(plan member lookup for assignment; needs tenant-admin consent),Notes.Read.All(OneNote, incl. team notebooks). Seedocs/graph-reference.mdfor the verified per-endpoint permissions.Planner needs a work/school account (plans live on Microsoft 365 groups). A personal account can use To Do only.
Setup
<repo> is your clone, <venv> wherever you keep the virtualenv
(on WSL, keep it in the Linux home, not on /mnt/c — it's flaky there).
python3 -m venv <venv>
<venv>/bin/pip install -e <repo> # Windows: <venv>\Scripts\pip
cd <repo>
cp .env.example .env # set TPM_CLIENT_ID, TPM_TENANT_ID, TPM_CLIENT_SECRET
cp .mcp.json.example .mcp.json # set "command" to <venv>/bin/python
<venv>/bin/python -m todo_planner_mcp.server --check # offline sanity check
<venv>/bin/python -m todo_planner_mcp.server --login # one-time sign-in--login prints a sign-in URL (secret mode: open it, and the browser redirects back to
the localhost listener; WSL2 forwards localhost from Windows) or a device code (public mode).
The token is cached at TPM_TOKEN_CACHE and refreshed silently afterwards.
.env is read from the project root regardless of the working directory.
Run as an MCP server
.mcp.json in the project root (git-ignored; copy from .mcp.json.example) registers the server with Claude Code (stdio). Claude Code
asks you to approve it the first time you start a session here. Run --login first,
because an interactive sign-in can't happen cleanly inside the MCP process.
Tools
To Do: todo_list_lists, todo_find_list, todo_create_list, todo_update_list,
todo_delete_list, todo_list_tasks, todo_get_task, todo_create_task,
todo_update_task, todo_complete_task, todo_delete_task,
todo_list_checklist_items, todo_add_checklist_item, todo_check_checklist_item,
todo_delete_checklist_item.
Planner: planner_my_tasks, planner_list_plans, planner_get_plan,
planner_list_buckets, planner_create_bucket, planner_list_tasks,
planner_get_task, planner_create_task, planner_update_task,
planner_assign_task, planner_unassign_task, planner_complete_task,
planner_delete_task, planner_set_description, planner_add_checklist_item,
planner_list_plan_members, planner_find_member.
OneNote (read-only, Notes.Read): onenote_list_notebooks, onenote_list_sections,
onenote_list_pages, onenote_search_pages (title only), onenote_get_page (content as plain text).
Health: whoami.
Notes
Planner PATCH/DELETE use optimistic concurrency; the client fetches the current
@odata.etagand retries once on 409/412 automatically.Secrets:
.envand the token cache are git-ignored. Keep them private.
License
MIT. See LICENSE. Provided as-is, without warranty.
Available Tools
38 toolsonenote_get_pageB
Read a page: metadata plus its content as plain text (to-dos shown as [ ] / [x]).
Inputs: page_id (required), max_chars.
onenote_list_notebooksA
List my OneNote notebooks (owned, shared with me, and my groups' team notebooks).
Inputs: no named parameters. Returns: result
onenote_list_pagesA
List pages in a section, or my most recently modified pages across all notebooks.
Inputs: top, section_id. Returns: result
onenote_list_sectionsA
List sections, either in one notebook or across all notebooks (includes nested section groups).
Inputs: notebook_id. Returns: result
onenote_search_pagesA
Find pages whose TITLE contains the text (case-insensitive). Does not search page bodies.
Inputs: query (required), top. Returns: result
planner_add_checklist_itemB
Add a checklist item to a Planner task (stored on task details). Involving people who haven't signed up needs the user's confirmation (see confirm_code).
Inputs: title (required), task_id (required), confirm_code.
planner_assign_taskB
Assign a task to one or more users (AAD user ids). Adds to existing assignees. Involving people who haven't signed up needs the user's confirmation (see confirm_code).
Inputs: task_id (required), assignee_ids (required), confirm_code.
planner_complete_taskA
Mark a Planner task complete (percentComplete=100). Involving people who haven't signed up needs the user's confirmation (see confirm_code).
Inputs: task_id (required), confirm_code.
planner_create_bucketC
Create a bucket in a plan.
Inputs: name (required), plan_id (required).
planner_create_taskA
Create a Planner task. due_date/start_date: 'YYYY-MM-DD' or ISO datetime. assignee_ids: AAD user ids to assign. priority: 0-10 (1 urgent, 3 important, 5 medium, 9 low). Assigning people who haven't signed up needs the user's confirmation (see confirm_code).
Inputs: title (required), plan_id (required), due_date, priority, +4 more.
planner_delete_taskC
Delete a Planner task. Involving people who haven't signed up needs the user's confirmation (see confirm_code).
Inputs: task_id (required), confirm_code. Returns: result
planner_find_memberA
Find plan members by name or email substring (returns user ids for assignment).
Inputs: query (required), plan_id (required). Returns: result
planner_get_planC
Get a plan's metadata.
Inputs: plan_id (required).
planner_get_taskB
Get a Planner task plus its details (checklist, description, references).
Inputs: task_id (required).
planner_list_bucketsB
List the buckets (columns) of a plan.
Inputs: plan_id (required). Returns: result
planner_list_plan_membersA
List the members of a plan's owning M365 group (to get user ids for assignment).
Inputs: plan_id (required). Returns: result
planner_list_plansA
List Planner plans I can see: shared with me, plus plans in my M365 groups.
Inputs: no named parameters. Returns: result
planner_list_tasksC
List all tasks in a plan.
Inputs: plan_id (required). Returns: result
planner_my_tasksA
List Planner tasks assigned to me across all plans (the 'Assigned to me' view).
Inputs: no named parameters. Returns: result
planner_set_descriptionB
Set the task's description (on plannerTaskDetails). Involving people who haven't signed up needs the user's confirmation (see confirm_code).
Inputs: task_id (required), description (required), confirm_code.
planner_unassign_taskA
Remove one or more users from a task's assignees. Involving people who haven't signed up needs the user's confirmation (see confirm_code).
Inputs: task_id (required), assignee_ids (required), confirm_code.
planner_update_taskB
Update task fields (ETag handled automatically). percent_complete: 0|1-99|100. Changing a task that involves people who haven't signed up needs the user's confirmation.
Inputs: task_id (required), title, due_date, priority, +4 more.
todo_add_checklist_itemC
Add a checklist item (subtask) to a task.
Inputs: list_id (required), task_id (required), display_name (required).
todo_check_checklist_itemC
Mark a checklist item checked/unchecked.
Inputs: item_id (required), list_id (required), task_id (required), checked.
todo_complete_taskC
Mark a task completed.
Inputs: list_id (required), task_id (required).
todo_create_listC
Create a new To Do list.
Inputs: display_name (required).
todo_create_taskC
Create a To Do task. due_date/reminder_date accept 'YYYY-MM-DD' or ISO datetime. importance: low|normal|high. body is the task note text.
Inputs: title (required), list_id (required), body, due_date, +3 more.
todo_delete_checklist_itemC
Delete a checklist item.
Inputs: item_id (required), list_id (required), task_id (required). Returns: result
todo_delete_listC
Delete a To Do list.
Inputs: list_id (required). Returns: result
todo_delete_taskC
Delete a task.
Inputs: list_id (required), task_id (required). Returns: result
todo_find_listA
Find a To Do list by (case-insensitive) display name. Returns the first match or {}.
Inputs: name (required).
todo_get_taskC
Get a single To Do task with full detail.
Inputs: list_id (required), task_id (required).
todo_list_checklist_itemsC
List checklist items (subtasks) of a task.
Inputs: list_id (required), task_id (required). Returns: result
todo_list_listsA
List all Microsoft To Do task lists (id + displayName + wellknownListName).
Inputs: no named parameters. Returns: result
todo_list_tasksB
List tasks in a list. Optional status filter (notStarted|inProgress|completed|waitingOnOthers|deferred).
Inputs: list_id (required), top, status. Returns: result
todo_update_listC
Rename a To Do list.
Inputs: list_id (required), display_name (required).
todo_update_taskC
Update any subset of a task's fields. status: notStarted|inProgress|completed|waitingOnOthers|deferred.
Inputs: list_id (required), task_id (required), body, title, +5 more.
whoamiA
Return the signed-in user (verifies Graph auth is working).
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 38 tools
Tools are cleanly partitioned by domain prefix (todo_, planner_, onenote_) and action, so most purposes are clearly distinct. Minor overlap exists between planner_find_member and planner_list_plan_members (both exist to obtain user ids for assignment), and todo_update_task vs todo_complete_task are close, but descriptions disambiguate.
Consistent snake_case verb_noun pattern with domain prefixes throughout (todo_create_task, planner_assign_task, onenote_get_page). Deviations are minor: the awkward todo_list_lists (list_lists) and the prefix-less whoami, which breaks the otherwise uniform scheme.
38 tools is heavy for a single server, sitting above the comfortable range. It is mitigated by spanning three distinct products (roughly 14 To Do, 17 Planner, 5 OneNote), each of which is reasonably scoped on its own, but the aggregate surface is large.
To Do has full list/task/checklist CRUD lifecycle and Planner covers task CRUD plus assignment and membership lookup. Gaps remain: Planner buckets can be created/listed but not updated/deleted, plans cannot be created/deleted, and OneNote is entirely read-only (no page creation or editing).
Maintenance
Related MCP Connectors
Manage tasks, Focus Zone, notes, projects, and task history from compatible AI assistants.
Calendars, tasks, contacts, bookings and agent inboxes for your assistant. EU-hosted, OAuth.
A graph-based task manager your agent can read and update: tasks, dependencies, blockers.
AI-powered to-do list: add, list, complete and organise tasks across lists from any assistant.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables AI assistants to manage Microsoft To Do tasks via the Graph API, supporting multiple accounts, encrypted auth, and full CRUD operations.2-
- FlicenseNot gradedqualityDmaintenanceEnables interaction with Microsoft Outlook Calendar and To Do lists via the Microsoft Graph API, allowing users to manage events and tasks through natural language.-
- AlicenseNot gradedqualityCmaintenanceEnables managing Microsoft To Do lists and tasks through MCP, including creating, updating, completing, deleting, searching, and checklist operations via Microsoft Graph.MIT
- AlicenseAqualityBmaintenanceEnables AI agents to read and edit Microsoft To Do tasks, lists, and steps via Microsoft Graph, including due dates, reminders, and subtasks.121MIT