Microsoft To Do MCP Server
This server lets Claude (or any MCP client) read and manage your Microsoft To Do lists and tasks through the Microsoft Graph API.
List task lists: View all your To Do lists (e.g., Tasks, Groceries)
Create/rename/delete lists: Manage task lists, including permanent deletion
List tasks: View tasks in a list, optionally filtered by status (notStarted, inProgress, completed, etc.)
Get task details: Retrieve full information about a single task, including notes
Create tasks: Add tasks with title, notes, due date, and importance
Update tasks: Change title, notes, due date, importance, or status
Complete tasks: Mark tasks as completed with a dedicated shortcut
Delete tasks: Permanently remove individual tasks
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., "@Microsoft To Do MCP Server List my tasks in the Groceries list."
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.
Microsoft To Do MCP Server
An MCP server that connects Claude (or any MCP-compatible client) to Microsoft To Do through the Microsoft Graph API — letting Claude read and manage your task lists and tasks on your behalf.
Runs entirely on your machine over stdio. No remote server ever sees your tasks or your tokens.
Features
Tool | Description |
| List all your task lists (Tasks, Groceries, etc.) |
| Create a new task list |
| Rename an existing list |
| Delete a list and all its tasks (destructive) |
| List tasks in a list, optionally filtered by status |
| Get the details of a single task |
| Create a task (title, notes, due date, importance) |
| Update fields on an existing task |
| Mark a task as completed |
| Delete a task (destructive) |
Related MCP server: Microsoft To Do MCP
Prerequisites
Node.js 18 or newer
A Microsoft account (personal or work/school)
Claude Desktop or another MCP-compatible client
1. Register an app in Azure AD
This server authenticates as your own Azure AD app registration, so you'll need to create one (free, takes a couple of minutes):
Go to the Azure Portal → App registrations and click New registration.
Give it a name (e.g. "Microsoft To Do MCP"), and under Supported account types choose an option that includes personal Microsoft accounts, unless you only intend to use a work/school account.
Under Redirect URI, select platform "Mobile and desktop applications" and add:
http://localhost:3000/callbackClick Register, then copy the Application (client) ID from the overview page — you'll need it later.
Go to Authentication and enable "Allow public client flows", then save.
Go to API permissions → Add a permission → Microsoft Graph → Delegated permissions, and add:
Tasks.ReadWriteoffline_accessUser.Read
2. Install & build
Clone this repository, then from the project folder:
git clone https://github.com/hoaaah/Microsoft-To-Do-MCP-Server.git
cd Microsoft-To-Do-MCP-Server
npm install
npm run buildThis compiles the TypeScript source into dist/index.js.
3. Configure AI Client / Claude Desktop
Open your AI Client / Claude Desktop config file:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.json
Add the following entry, replacing PATH_TO_THIS_FOLDER with the absolute path to where you cloned this repo, and MS_TODO_CLIENT_ID with the Application (client) ID from Azure:
{
"mcpServers": {
"microsoft-todo": {
"command": "node",
"args": ["PATH_TO_THIS_FOLDER/dist/index.js"],
"env": {
"MS_TODO_CLIENT_ID": "your-azure-client-id-here"
}
}
}
}Save the file and restart Claude Desktop.
4. First sign-in
The first time Claude calls one of the todo_* tools, your default browser will open automatically, asking you to sign in with your Microsoft account and approve the Tasks.ReadWrite permission. Once you approve, the token is cached locally at:
~/.microsoft-todo-mcp/token-cache.jsonSubsequent sign-ins are silent — the cached refresh token is reused automatically as long as it hasn't expired or been revoked, so you won't need to log in again.
Revoking access
To force a fresh sign-in, delete the cache file:
~/.microsoft-todo-mcp/token-cache.jsonTo fully revoke the app's access to your account, go to:
account.live.com/consent/Manage for personal Microsoft accounts
Azure AD → Enterprise Applications for work/school accounts
Security notes
This server runs locally on your machine over stdio — there is no remote server storing or relaying your tokens.
todo_delete_task_listandtodo_delete_taskare destructive and cannot be undone. Claude will ask for confirmation before calling them.Your Azure app's client ID is not a secret and is safe to keep in your local config, but you should not commit it to a public repository alongside real task data or tokens.
Troubleshooting
Browser doesn't open on first sign-in: make sure port
3000is free, and that the redirect URI in your Azure app registration exactly matcheshttp://localhost:3000/callback."Need admin approval" error: your organization may require an admin to consent to the requested permissions — contact your Microsoft 365 administrator, or use a personal Microsoft account instead.
Claude doesn't see the tools: double-check the path in
claude_desktop_config.jsonpoints to the builtdist/index.js, and that you restarted Claude Desktop after editing the config.
License
Creator
This MCP was created by and is maintained by Heru Arief Wijaya.
Available Tools
10 toolstodo_complete_taskMark a Microsoft To Do Task as CompleteAIdempotent
Mark a task as completed (shortcut for todo_update_task with status=completed).
Inputs: list_id (required), task_id (required).
todo_create_taskCreate a Microsoft To Do TaskA
Create a new task in a given Microsoft To Do list. Get list_id from todo_list_task_lists first.
Inputs: title (required), list_id (required), notes, due_date, +1 more.
todo_create_task_listCreate Microsoft To Do ListA
Create a new Microsoft To Do task list with the given display name. Returns the new list's id.
Inputs: display_name (required).
todo_delete_taskDelete a Microsoft To Do TaskADestructiveIdempotent
Permanently delete a task. This cannot be undone. Confirm with the user before calling this.
Inputs: list_id (required), task_id (required).
todo_delete_task_listDelete Microsoft To Do ListADestructiveIdempotent
Permanently delete a Microsoft To Do task list AND all tasks inside it. This cannot be undone. Confirm with the user before calling this.
Inputs: list_id (required).
todo_get_taskGet a Single Microsoft To Do TaskARead-onlyIdempotent
Get full details of a single task, including its notes.
Inputs: list_id (required), task_id (required).
todo_list_task_listsList Microsoft To Do ListsARead-onlyIdempotent
List all Microsoft To Do task lists for the signed-in user (e.g. 'Tasks', 'Groceries'). Returns each list's display name and id. Use the id with todo_list_tasks to see tasks inside a list.
Inputs: no named parameters.
todo_list_tasksList Tasks in a Microsoft To Do ListARead-onlyIdempotent
List tasks inside a given Microsoft To Do list. Supports filtering by status. Get list_id from todo_list_task_lists first.
Inputs: list_id (required), limit, status_filter.
todo_rename_task_listRename Microsoft To Do ListAIdempotent
Rename an existing Microsoft To Do task list.
Inputs: list_id (required), display_name (required).
todo_update_taskUpdate a Microsoft To Do TaskAIdempotent
Update fields on an existing task (title, notes, due date, importance, or status). Only the fields you provide are changed. To mark a task done, prefer todo_complete_task.
Inputs: list_id (required), task_id (required), notes, title, +3 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 10 tools
Each tool targets a distinct resource and action: task lists vs. tasks, and operations like list, create, rename, delete, get, update, complete are clearly separated. The only potential overlap is todo_complete_task being a shortcut for todo_update_task, but the description explicitly clarifies this.
All tool names follow a consistent todo_verb_noun pattern, with verbs like list, create, rename, delete, get, update, complete applied uniformly to the two resources (task lists and tasks). This makes the API predictable and easy to navigate.
10 tools is well-scoped for a Microsoft To Do server, covering both task list management and task management without unnecessary bloat. Each tool serves a clear, distinct purpose and earns its place.
The server provides full CRUD coverage for task lists (list, create, rename, delete) and tasks (list, get, create, update, complete, delete), covering the core lifecycle. The complete_task shortcut is a sensible addition for a common operation.
Maintenance
Related MCP Connectors
Task management for people and AI agents, with scoped OAuth access to issues, projects, and docs.
Task management for people and AI agents, with scoped OAuth access to issues, projects, and docs.
Taskade projects, tasks and AI agents. Hosted OAuth server or local stdio package.
Simple, fast todo app: manage tasks, projects and tags from Claude and other MCP clients.
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-
- AlicenseNot gradedqualityDmaintenanceA Model Context Protocol (MCP) server that enables AI assistants like Claude and Cursor to interact with Microsoft To Do via the Microsoft Graph API.MIT
- FlicenseNot gradedqualityCmaintenanceProvides AI assistants with tools and a resource to manage a personal to-do list, enabling adding, listing, retrieving, completing, and deleting tasks over stdio.-
- AlicenseBqualityCmaintenanceLets Claude and other AI clients read and modify Microsoft To Do through natural language, adding, completing, searching, updating, and deleting tasks and sub-steps by title and list name instead of ids. Personal Microsoft accounts need no Azure app registration — a single device-code sign-in grants access, with optional read-only and no-delete modes available.18MIT