Skip to main content
Glama

mstodo-bridge

npm license

Manage Microsoft To Do directly in Claude. An MCP server with zero-configuration setup; sign-in happens right in the conversation.

Installation

1. Install into Claude Code

claude mcp add -s user taskbridge -- npx -y mstodo-bridge

-s user applies globally (available in all projects). Restart your Claude Code session after finishing.

2. Or write to an MCP config file

Claude Desktop: edit the config file (Windows %APPDATA%\Claude\claude_desktop_config.json, macOS ~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "taskbridge": {
      "command": "npx",
      "args": ["-y", "mstodo-bridge"]
    }
  }
}

Cursor / other MCP clients: add it the same way with npx -y mstodo-bridge as the stdio command. Save and restart the client.

3. Or start a web service

It does not need to be attached to a client; it can also run standalone as a service with an admin console:

npx mstodo-bridge --http        # 管理台 http://127.0.0.1:46377/admin

On first launch it prints an admin password and an MCP Bearer token (shown only once). Other clients can then connect remotely via http://<host>:46377/mcp (Bearer auth); see "Deployment" below for deploying to a server / Hugging Face Spaces.

Related MCP server: Remote MCP Entra ID Todo

Sign-in

After restarting the client, just tell Claude:

Help me connect to Microsoft To Do

Claude will call the login tool and give you an authorization link → open it in a browser → consent with your Microsoft personal account → it automatically reconnects and completes. After that you can operate in natural language:

Show my lists · Add X to "Research & Academics", due Friday · Search tasks containing "paper" · Complete item 3

Option 2: Through the web admin console

npx mstodo-bridge --http --open
  1. Open the admin console in a browser and sign in with the admin password printed at startup;

  2. On the Microsoft To Do card, click "Connect account"; after completing authorization in the browser, it automatically redirects back;

  3. In remote environments (browser and server are not on the same machine), after authorization it will jump to localhost and show an error — this is expected; just paste the full URL from the address bar into the "Complete connection" input box on the card.

Both methods produce exactly the same credentials (~/.mstodo-bridge), so feel free to mix them.

MCP tools (15)

Account & sign-in

Tool

Parameters

Description

login

callbackUrl?

One tool to complete the entire sign-in flow: no argument = start, returns an authorization link and user-facing instructions (including local callback listening); with the user-pasted URL from the address bar = finish the exchange (remote scenario)

logout

—

Disconnect account: removes local tokens and any in-progress sign-in (Microsoft-side authorization must be revoked at account.microsoft.com)

login_status

—

Whether connected, whether sign-in is in progress, and seconds remaining

list_providers

—

List providers with their connection status and capability declarations

Lists

Tool

Parameters

Description

list_task_lists

provider?

List all lists

create_task_list

name, provider?

Create a new list

delete_task_list

listId, provider?

Delete a list and its tasks (not recoverable)

Task reading

Tool

Parameters

Description

list_tasks

listId?, includeCompleted?, cursor?

List tasks; omit listId to aggregate across all lists; cursor paginates

get_task

listId, taskId

Get a single task's details

search_tasks

query, provider?

Search title and notes by substring across lists

Task writing

Tool

Parameters

Description

create_task

title, listId?, notes?, dueDate?, parentTaskId?

Create; dueDate accepts an ISO date or RFC 3339; omit the list to use the default list

update_task

listId, taskId, title?, notes?, dueDate?, status?

Partial update; dueDate: null clears the due date; status is completed / needsAction

complete_task

listId, taskId

Mark as complete

delete_task

listId, taskId

Delete a task

move_task_between_lists

fromListId, taskId, toListId

Move between lists (recreates the item in the target list, then deletes the source task)

Parameters marked with provider? can be omitted in single-account mode.

Deployment

PORT=7860 HOST=0.0.0.0 PUBLIC_BASE_URL=https://<user>-<space>.hf.space npx mstodo-bridge --http

Environment variable / flag

Description

ADMIN_PASSWORD

Admin console password (auto-generated if missing)

PUBLIC_BASE_URL

Public base URL; determines how the authorization callback is displayed and redirected

TASKBRIDGE_PROXY / HTTPS_PROXY

Outbound proxy (http/https only; for SOCKS, use your proxy software's mixed port)

TASKBRIDGE_MS_CLIENT_ID

Override the built-in OAuth client ID

TASKBRIDGE_CONFIG_DIR

Credentials directory (default ~/.mstodo-bridge)

--port / PORT

Listening port (default 46377; use PORT on hosted platforms)

Security

Credentials are kept only locally (~/.mstodo-bridge, permissions 0600); passwords and tokens are stored only as scrypt hashes with constant-time comparison; OAuth uses PKCE plus a one-time state throughout; the admin console has strict CSP and login rate limiting. When a refresh token becomes invalid, it is automatically cleared and you are guided to reconnect.

Development

git clone https://github.com/WNJXYK/MSTodo-Bridge && cd MSTodo-Bridge
npm install && npm run build && npm test

Issues and PRs are welcome at GitHub.

License

MIT

Available Tools

15 tools
complete_taskC

Mark a task completed.

Inputs: listId (required), taskId (required), provider.

create_taskB

Create a task. dueDate accepts ISO date (2026-08-25) or RFC 3339 datetime. parentTaskId nests it as a subtask where supported.

Inputs: title (required), notes, listId, dueDate, +2 more.

create_task_listC

Create a new task list (folder).

Inputs: name (required), provider.

delete_taskB

Delete a task permanently.

Inputs: listId (required), taskId (required), provider.

delete_task_listA

Delete an entire task list and its tasks. Irreversible.

Inputs: listId (required), provider.

get_taskC

Fetch one task by list and task id.

Inputs: listId (required), taskId (required), provider.

list_providersA

Show the Microsoft To Do provider and its auth state and capabilities. Run this first to learn what is available.

Inputs: no named parameters.

list_task_listsA

List the task lists (folders) of a provider.

Inputs: provider.

list_tasksA

List tasks. Give listId for one list; omit it to page across every list of the provider.

Inputs: cursor, listId, provider, includeCompleted.

loginA

Connect Microsoft To Do. Call WITHOUT arguments to start: it returns an authorize URL for the user to open and consent, plus a ready-to-relay message covering the paste-back fallback. When the user later sends you a localhost callback URL from their address bar, call login AGAIN passing it as callbackUrl to finish.

Inputs: callbackUrl.

login_statusA

Check whether Microsoft To Do is connected. Use before task tools; if not connected, call login.

Inputs: no named parameters.

logoutA

Disconnect Microsoft To Do: deletes the locally stored tokens (and any pending login). The Microsoft-side app consent is NOT revoked; to fully revoke, remove the app at account.microsoft.com > Privacy.

Inputs: no named parameters.

move_task_between_listsA

Recreate an existing task in another list and delete it from the source list (Graph To Do has no native move). Use to reorganize.

Inputs: taskId (required), toListId (required), fromListId (required), provider.

search_tasksA

Search open tasks by substring across every list of every connected provider.

Inputs: query (required), provider.

update_taskA

Update a task (partial). Set status "completed" or "needsAction", change title/notes, or set dueDate (null removes it).

Inputs: listId (required), taskId (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

    B3.4/5.0

    Scored across 15 tools

    Disambiguation3/5

    Most tools target distinct resources and actions, but there are overlapping boundaries: update_task can mark a task completed, making complete_task redundant, and login_status overlaps with list_providers for checking auth state. Descriptions help clarify intended use, but an agent could still struggle to choose between these pairs.

    Naming Consistency4/5

    Task and list tools consistently follow a verb_noun pattern: list_tasks, create_task, delete_task_list, move_task_between_lists. The auth tools (login, login_status, logout) deviate from that pattern, but they form their own predictable auth-related group, so the overall naming is mostly consistent.

    Tool Count4/5

    Fifteen tools is on the upper end of the ideal range but is reasonable for a Microsoft To Do bridge covering auth, providers, task lists, and individual tasks. A few tools like complete_task and list_providers feel somewhat redundant, suggesting the count could be trimmed slightly, but it is not excessive.

    Completeness4/5

    The server covers the core lifecycle well: list, create, get, update, complete, delete, search, and move tasks, plus list and auth management. Minor gaps exist, such as no way to rename a task list and no dedicated get_task_list operation, but agents can work around these with the available tools.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      Enables users to manage a persistent todo list through natural language, supporting adding, listing, toggling completion status, and removing todos. Features both stdio and HTTP transports with optional authentication and JSON file storage.
      4
      ISC
    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables comprehensive Microsoft To Do task management through Microsoft Graph API with Entra ID OAuth authentication. Supports creating, updating, and managing todo lists, tasks, reminders, and due dates through natural language.
      -
    • 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
      -