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
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-serverWhat 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-serverReplace <…> with your own values
Platform CLI
codex mcp add microsoft-todo-mcp-server --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> -- npx -y microsoft-todo-mcp-serverReplace <…> with your own values
Config file
{
"mcpServers": {
"microsoft-todo-mcp-server": {
"command": "npx",
"args": [
"-y",
"microsoft-todo-mcp-server"
],
"env": {
"MS_TODO_ACCESS_TOKEN": "<MS_TODO_ACCESS_TOKEN>",
"MS_TODO_REFRESH_TOKEN": "<MS_TODO_REFRESH_TOKEN>",
"CLIENT_ID": "<CLIENT_ID>",
"CLIENT_SECRET": "<CLIENT_SECRET>",
"TENANT_ID": "<TENANT_ID>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"microsoft-todo-mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"microsoft-todo-mcp-server"
],
"env": {
"MS_TODO_ACCESS_TOKEN": "<MS_TODO_ACCESS_TOKEN>",
"MS_TODO_REFRESH_TOKEN": "<MS_TODO_REFRESH_TOKEN>",
"CLIENT_ID": "<CLIENT_ID>",
"CLIENT_SECRET": "<CLIENT_SECRET>",
"TENANT_ID": "<TENANT_ID>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e MS_TODO_ACCESS_TOKEN=<MS_TODO_ACCESS_TOKEN> -e MS_TODO_REFRESH_TOKEN=<MS_TODO_REFRESH_TOKEN> -e CLIENT_ID=<CLIENT_ID> -e CLIENT_SECRET=<CLIENT_SECRET> -e TENANT_ID=<TENANT_ID> microsoft-todo-mcp-server npx -y microsoft-todo-mcp-serverReplace <…> 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.