MCP Microsoft Todo
MCP server that lets AI clients read and manage Microsoft To Do tasks via Microsoft Graph
- Pricing
- Open source
- Platforms
- CLI, macOS, Windows
- Runs
- Locally
- Version
- 1.2.2
- Listing updated
- today
Similar MCP servers
About MCP Microsoft Todo
MCP Microsoft Todo is an open-source MCP server for productivity. It runs locally on your machine and is started by your AI client.
The README describes this as an MCP server that connects Claude Code, Claude Desktop and other stdio-compatible clients to Microsoft To Do. It authenticates with the device code flow through MSAL, so a user signs in once in a browser and the token is cached locally, with no Azure App Registration needed on the user's side.
Once connected, the assistant can list task lists, create tasks with due dates, reminders and recurrence, complete or move tasks, manage checklist items and linked resources, and run cross-list queries such as overdue tasks or a daily summary. The README lists 28 tools in total, and batch operations accept up to 100 tasks per Graph call.
It suits people who already keep their to-dos in Microsoft To Do, whether on a personal Outlook account or a work Microsoft 365 tenant, and want an assistant to work with those lists directly. The README says the token stays on the user's machine and that no data passes through the vendor's servers.
Install
Run in a terminal
claude mcp add mcp-microsoft-todo --env MS_CLIENT_ID='<MS_CLIENT_ID>' -- npx -y @mag-cie/mcp-microsoft-todoAdd to claude_desktop_config.json
{
"mcpServers": {
"mcp-microsoft-todo": {
"command": "npx",
"args": [
"-y",
"@mag-cie/mcp-microsoft-todo"
],
"env": {
"MS_CLIENT_ID": "<MS_CLIENT_ID>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"mcp-microsoft-todo": {
"command": "npx",
"args": [
"-y",
"@mag-cie/mcp-microsoft-todo"
],
"env": {
"MS_CLIENT_ID": "<MS_CLIENT_ID>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"mcp-microsoft-todo": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@mag-cie/mcp-microsoft-todo"
],
"env": {
"MS_CLIENT_ID": "<MS_CLIENT_ID>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"mcp-microsoft-todo": {
"command": "npx",
"args": [
"-y",
"@mag-cie/mcp-microsoft-todo"
],
"env": {
"MS_CLIENT_ID": "<MS_CLIENT_ID>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"mcp-microsoft-todo": {
"command": "npx",
"args": [
"-y",
"@mag-cie/mcp-microsoft-todo"
],
"env": {
"MS_CLIENT_ID": "<MS_CLIENT_ID>"
}
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
MS_CLIENT_IDApplication (client) ID from your Azure AD App Registration. See the README for setup instructions.RequiredMS_TENANTMicrosoft tenant: 'common' (personal + work), 'consumers' (personal only), 'organizations' (work only), or your specific tenant ID.
Tools this server provides (28)
Taken from the project documentation; the running server may differ.
- 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 and overdue
- list_all_tasks
- Every task across every list in one round-trip
- batch_create_tasks
- Create up to 100 tasks in a single Graph batch 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
- list_checklist_items
- Sub-items of a task
- create_checklist_item
- Add a sub-item
- update_checklist_item
- Rename, check or uncheck a sub-item
- delete_checklist_item
- Delete a sub-item
- list_linked_resources
- List the linked resources of a task
- create_linked_resource
- Attach a URL or external reference
- delete_linked_resource
- Delete a linked resource
- list_extensions
- List the open extensions of a task
- set_extension
- Create or update an extension
- delete_extension
- Delete an extension
- list_overdue_tasks
- All overdue tasks across all lists
- list_tasks_by_category
- All tasks with a given category, cross-lists
- bulk_update_categories
- Add or remove categories on many tasks
- export_tasks_ics
- iCalendar export (VTODO, RRULE, VALARM)
What it does
- Device code sign-in
- Authenticates through the Microsoft device code flow, so no client secret or Azure setup is needed by the end user.
- Full task management
- Creates, updates, completes, moves and deletes tasks, including due dates, reminders and recurrence.
- Batch operations
- Creates, completes or deletes up to 100 tasks in a single Microsoft Graph request.
- Cross-list queries
- Searches by title, lists overdue tasks and tasks by category across all lists, and gives a summary of today.
- iCalendar export
- Exports tasks as VTODO entries for import into common calendar applications.
- Safety annotations
- Tools carry MCP hints for read-only, destructive and idempotent behaviour so clients can decide when to confirm.
Good for
- Asking an assistant what is due today or overdue in Microsoft To Do
- Bulk-tagging or completing a batch of tasks from a chat prompt
- Creating recurring tasks and reminders by describing them in natural language
- Exporting work to-do lists as an iCalendar file
Pricing
Open source
Free and open-source under the MIT licence.
MCP Microsoft Todo FAQ
Does it need an Azure App Registration?
The README says no: end users sign in with the device code flow and do not need to create an Azure App Registration. Forks and local development do require one.
Which Microsoft accounts are supported?
The README says it works with personal Microsoft accounts such as outlook.com, hotmail.com and live.com, as well as Microsoft 365 work accounts. Personal accounts should set MS_TENANT to consumers.
Where is the sign-in token stored?
According to the README, the token is cached in a file in the user's home directory under .mcp-microsoft-todo and is not sent to the vendor's servers.
What does it cost?
The README states the server is open-source under the MIT licence and free to use.
Is MCP Microsoft Todo free?
Yes. MCP Microsoft Todo is open source, so you can use and self-host it for free.
How do I add MCP Microsoft Todo to Claude Code?
Run this command in your terminal: claude mcp add mcp-microsoft-todo --env MS_CLIENT_ID='<MS_CLIENT_ID>' -- npx -y @mag-cie/mcp-microsoft-todo
What are the best alternatives to MCP Microsoft Todo?
The closest alternatives to MCP Microsoft Todo are Microsoft Todo MCP Server, To-do Calendar, Omnido, Taskade MCP and GetItDone.
Where this comes from
- Description: written from the project's README and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.
