Skip to main content
MCP server CX Codex

microsoft-todo-mcp-server — Claude Code MCP server for Microsoft To Do

microsoft-todo-mcp-server — an MCP server for Microsoft To Do via Graph API. Creates task lists, tasks, checklist items and reminders directly from the agent.

no license ★ 122 updated 2026-10-28

Install into Claude Code · Platform CLI All methods and platforms ↓
claude mcp add --env MS_TODO_ACCESS_TOKEN=<MS_TODO_ACCESS_TOKEN> --env MS_TODO_REFRESH_TOKEN=<MS_TODO_REFRESH_TOKEN> --env CLIENT_ID=<CLIENT_ID> --env CLIENT_SECRET=<CLIENT_SECRET> --env TENANT_ID=<TENANT_ID> --transport stdio microsoft-todo-mcp-server -- npx -y microsoft-todo-mcp-server
Open on GitHub

What microsoft-todo-mcp-server does

Connects Microsoft To Do to Claude Code, Cursor and other agents through MCP. The agent can create task lists, add tasks, nest subtasks, set deadlines and reminders — all through Graph API.

Works with personal, work and school Microsoft accounts. Tokens refresh automatically: the server reads the expiry from the JWT for work accounts and assumes an hour for personal ones. Tokens are stored in ~/.config/microsoft-todo-mcp/tokens.json or %APPDATA%\microsoft-todo-mcp\tokens.json on Windows. Without CLIENT_SECRET in environment variables, refresh won't work and calls will start failing when the token expires.

Requires Node.js 16 or higher, Azure App Registration with Tasks.Read, Tasks.ReadWrite, User.Read permissions. Before installing, get tokens by running pnpm run auth in the cloned repository — the command opens a browser for OAuth and saves the result to tokens.json.

What it helps with

  • add a task to Microsoft To Do from a prompt
  • create a task list and populate it with items
  • set a reminder on a task
  • read a checklist from To Do and append to it
  • sync work tasks between the agent and Microsoft To Do

Example prompts for the agent

  • Create a list called Release v2 and add a task Check migrations
  • Set a reminder for tomorrow at 10am for the task Call with designer
  • Show all tasks from the Backlog list and mark completed ones

How to install microsoft-todo-mcp-server

Platform CLI

claude mcp add --env MS_TODO_ACCESS_TOKEN=<MS_TODO_ACCESS_TOKEN> --env MS_TODO_REFRESH_TOKEN=<MS_TODO_REFRESH_TOKEN> --env CLIENT_ID=<CLIENT_ID> --env CLIENT_SECRET=<CLIENT_SECRET> --env TENANT_ID=<TENANT_ID> --transport stdio microsoft-todo-mcp-server -- npx -y microsoft-todo-mcp-server

Replace <…> with your own values

Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more

Questions about microsoft-todo-mcp-server

How to install microsoft-todo-mcp-server in Claude Code?

Run `claude mcp add microsoft-todo-mcp-server -e MS_TODO_ACCESS_TOKEN=<MS_TODO_ACCESS_TOKEN> -e MS_TODO_REFRESH_TOKEN=<MS_TODO_REFRESH_TOKEN> -e CLIENT_SECRET=<CLIENT_SECRET> -- npx -y microsoft-todo-mcp-server. Tokens must be obtained beforehand via pnpm run auth` in the repository.

What does microsoft-todo-mcp-server do?

Connects Microsoft To Do to the agent through Graph API. The agent can create lists, tasks, subtasks, set reminders and read existing items.

Which Microsoft accounts are supported?

Personal, work and school. The type is specified via TENANT_ID: consumers for personal, organizations for corporate, common for both, or a specific ID for a single organization.

Similar MCP servers

All MCP servers for Notes, tasks and projects →

Project sponsors

Companies that keep this analytics open