Skip to content
MCP server

MCP Microsoft Todo

MCP server that lets AI clients read and manage Microsoft To Do tasks via Microsoft Graph

Runs locallyStatus and history
Install
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-todo

Add 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.Required
  • MS_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.

How AIPoweredBot checks servers