# MCP Microsoft Todo

> MCP Microsoft Todo is an open-source MCP server for productivity. MCP server that lets AI clients read and manage Microsoft To Do tasks via Microsoft Graph. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Windows, Linux, self-hosted
- **Repository:** https://github.com/mag-cie/mcp-microsoft-todo
- **MCP Registry name:** io.github.MAG-Cie/mcp-microsoft-todo
- **Categories:** [productivity](https://ai-powered.com/categories/productivity)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add mcp-microsoft-todo --env MS_CLIENT_ID='<MS_CLIENT_ID>' -- npx -y @mag-cie/mcp-microsoft-todo
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mcp-microsoft-todo": {
      "command": "npx",
      "args": [
        "-y",
        "@mag-cie/mcp-microsoft-todo"
      ],
      "env": {
        "MS_CLIENT_ID": "<MS_CLIENT_ID>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp-microsoft-todo": {
      "command": "npx",
      "args": [
        "-y",
        "@mag-cie/mcp-microsoft-todo"
      ],
      "env": {
        "MS_CLIENT_ID": "<MS_CLIENT_ID>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp-microsoft-todo": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@mag-cie/mcp-microsoft-todo"
      ],
      "env": {
        "MS_CLIENT_ID": "<MS_CLIENT_ID>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp-microsoft-todo": {
      "command": "npx",
      "args": [
        "-y",
        "@mag-cie/mcp-microsoft-todo"
      ],
      "env": {
        "MS_CLIENT_ID": "<MS_CLIENT_ID>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp-microsoft-todo": {
      "command": "npx",
      "args": [
        "-y",
        "@mag-cie/mcp-microsoft-todo"
      ],
      "env": {
        "MS_CLIENT_ID": "<MS_CLIENT_ID>"
      }
    }
  }
}
```

## Tools

- `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)

## 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.

## Alternatives

- [Microsoft Todo MCP Server](https://ai-powered.com/mcp/microsoft-todo-mcp-server): Microsoft Todo MCP Server is an open-source MCP server for productivity.
- [To-do Calendar](https://ai-powered.com/mcp/to-do-calendar): To-do Calendar is an MCP server for productivity.
- [Omnido](https://ai-powered.com/mcp/omnido): Omnido is a freemium MCP server for productivity.
- [Taskade MCP](https://ai-powered.com/mcp/taskade-mcp): Taskade MCP is a freemium MCP server for productivity.
- [GetItDone](https://ai-powered.com/mcp/getitdone): GetItDone is a freemium MCP server for productivity.
- [Todo MCP](https://ai-powered.com/mcp/todo-mcp-2): Todo MCP is an open-source MCP server for productivity.
- [DoDo](https://ai-powered.com/mcp/dodo): DoDo is a free MCP server for productivity.
- [Todoist](https://ai-powered.com/mcp/todoist-2): Todoist is a freemium MCP server for productivity.

---
Source: https://ai-powered.com/mcp/mcp-microsoft-todo
