Skip to main content
Glama
Microsoft To Do MCP Server

Microsoft To Do MCP Server

by hoaaah

Microsoft To Do MCP Server

M8ven Verified

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

todo_list_task_lists

List all your task lists (Tasks, Groceries, etc.)

todo_create_task_list

Create a new task list

todo_rename_task_list

Rename an existing list

todo_delete_task_list

Delete a list and all its tasks (destructive)

todo_list_tasks

List tasks in a list, optionally filtered by status

todo_get_task

Get the details of a single task

todo_create_task

Create a task (title, notes, due date, importance)

todo_update_task

Update fields on an existing task

todo_complete_task

Mark a task as completed

todo_delete_task

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

  1. Go to the Azure Portal → App registrations and click New registration.

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

  3. Under Redirect URI, select platform "Mobile and desktop applications" and add:

    http://localhost:3000/callback
  4. Click Register, then copy the Application (client) ID from the overview page — you'll need it later.

  5. Go to Authentication and enable "Allow public client flows", then save.

  6. Go to API permissions → Add a permission → Microsoft Graph → Delegated permissions, and add:

    • Tasks.ReadWrite

    • offline_access

    • User.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 build

This 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.json

  • Windows: %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.json

Subsequent 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.json

To fully revoke the app's access to your account, go to:

Security notes

  • This server runs locally on your machine over stdio — there is no remote server storing or relaying your tokens.

  • todo_delete_task_list and todo_delete_task are 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 3000 is free, and that the redirect URI in your Azure app registration exactly matches http://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.json points to the built dist/index.js, and that you restarted Claude Desktop after editing the config.

License

MIT

Creator

This MCP was created by and is maintained by Heru Arief Wijaya.

Available Tools

10 tools
todo_complete_taskMark a Microsoft To Do Task as CompleteA
Idempotent

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 TaskA
DestructiveIdempotent

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 ListA
DestructiveIdempotent

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 TaskA
Read-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 ListsA
Read-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 ListA
Read-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 ListA
Idempotent

Rename an existing Microsoft To Do task list.

Inputs: list_id (required), display_name (required).

todo_update_taskUpdate a Microsoft To Do TaskA
Idempotent

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

    A4.3/5.0

    Scored across 10 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness5/5

    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

    ActivityStale
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to manage Microsoft To Do tasks via the Graph API, supporting multiple accounts, encrypted auth, and full CRUD operations.
      2
      -
    • A
      license
      B
      quality
      C
      maintenance
      Lets 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.
      18
      MIT