Mcp Microsoft Todo
by MAG-Ciecommunityv1.2.2
7
1
MCP server that lets MCP-compatible clients manage Microsoft To Do tasks, lists, checklist items, linked resources, and task metadata through Microsoft Graph. It supports sign-in with any Microsoft account via device code flow and does not require Azure setup.
From the registry: MCP server for Microsoft To Do via Microsoft Graph. MSAL device code flow, no client secret needed.
Install & configure
Prerequisites
- requiredInstall Node.js 20+Node.js version 20 or later is required to run the MCP server via npx.https://nodejs.org/
- requiredHave a Microsoft accountA Microsoft account is required to authenticate with Microsoft To Do. Personal and business Microsoft accounts are supported.
- optionalAuthenticate once via device code flowRecommended first-run setup: launch the package with --auth in a terminal so you can complete Microsoft device-code sign-in and cache the token locally for future MCP use.
$ npx -y @mag-cie/mcp-microsoft-todo@latest --auth
Install in your client
Paste into the AI you're chatting with — it will figure out the rest
Please install the `mcp-microsoft-todo` MCP server into my current AI client (that's you).
Required prerequisites (do these first if not already done):
- **Install Node.js 20+** — Node.js version 20 or later is required to run the MCP server via npx. (https://nodejs.org/)
- **Have a Microsoft account** — A Microsoft account is required to authenticate with Microsoft To Do. Personal and business Microsoft accounts are supported.
Optional prerequisites:
- Authenticate once via device code flow — Recommended first-run setup: launch the package with --auth in a terminal so you can complete Microsoft device-code sign-in and cache the token locally for future MCP use. Run: `npx -y @mag-cie/mcp-microsoft-todo@latest --auth`
Canonical MCP server config (stdio transport):
- command: `npx`
- args: ["-y","@mag-cie/mcp-microsoft-todo"]
- optional environment variables:
- `MS_TENANT`: Microsoft tenant/account type to use during authentication. Set to consumers for personal Microsoft accounts such as outlook.com, hotmail.com, live.com, msn.com, or Office 365 personal; otherwise omit for default behavior. (example: `consumers`)
- `MCP_LOCALE`: Optional locale for compact server-returned strings. Supported values documented are en, fr, es, and de. (example: `fr`)
Note: The server uses stdio. The official npm package includes the client ID, so no Azure setup or MS_CLIENT_ID is needed for normal end-user installation. MS_CLIENT_ID appears only for developer forks/local builds and is not part of the preferred install path. Authentication tokens are cached locally in ~/.mcp-microsoft-todo/token-cache.json.
Add this MCP server to my current client's config in the correct format for you. If you need secrets or credentials I haven't provided, ASK me — do not invent values or leave raw placeholders. After adding it, tell me how to verify the server is connected.Note: The server uses stdio. The official npm package includes the client ID, so no Azure setup or MS_CLIENT_ID is needed for normal end-user installation. MS_CLIENT_ID appears only for developer forks/local builds and is not part of the preferred install path. Authentication tokens are cached locally in ~/.mcp-microsoft-todo/token-cache.json.
Tools (28)
list_task_lists
All your To Do lists
list_tasks
Tasks of a list (OData filter, $orderby, paginate)
get_task
Detail of a task by ID
create_task
Create a task (title, body, importance, due date, categories, recurrence, reminder)
update_task
Update title, status, due date, recurrence, reminder…
complete_task
Mark as completed
delete_task
Delete permanently
move_task
Move a task from one list to another (source task is deleted)
search_tasks
Cross-list search by title
summarize_today
Summary of tasks due today + overdue
list_all_tasks
Every task across every list in one round-trip (uses Graph $batch)
batch_create_tasks
Create up to 100 tasks in a single Graph $batch HTTP call
batch_complete_tasks
Mark up to 100 tasks as completed in one call
batch_delete_tasks
Delete up to 100 tasks in one call
Environment variables
MS_TENANTrequiredSet to consumers for personal Microsoft accounts; used for Microsoft sign-in tenant selectionPrerequisites
- • Node.js 20+
- • Node 20+
Packages
@mag-cie/mcp-microsoft-todo
npmv1.2.2transport: stdio
Details
- Language
- TypeScript
- License
- MIT
- Released
- May 5, 2026
- Last commit
- May 11, 2026
- Registry name
- io.github.MAG-Cie/mcp-microsoft-todo