Microsoft To Do MCP
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Microsoft To Do MCP
A Model Context Protocol (MCP) server that enables AI assistants like Claude and Cursor to interact with Microsoft To Do via the Microsoft Graph API. This service provides comprehensive task management capabilities through a secure OAuth 2.0 authentication flow.
Features
15 MCP Tools: Complete task management including lists, tasks, checklist items, bulk archiving, and organized views
Task Creation Timestamps: Surfaces
createdDateTimeon all tasks so you can see when each was addedSmart Organized Views: Groups task lists by naming patterns, emoji prefixes, and sharing status
Bulk Archive: Move completed tasks older than N days to an archive list, with dry-run preview
Seamless Authentication: Automatic token refresh with zero manual intervention
OAuth 2.0: Secure authentication via MSAL with PKCE flow
Microsoft Graph API v1.0: Direct integration with Microsoft's official API
Multi-tenant Support: Works with personal, work, and school Microsoft accounts
TypeScript + ESM: Fully typed, modern module system
Related MCP server: todo-mcp
Remote deployment (Cloudflare Workers)
The worker/ folder runs the same tools as a remote MCP server with per-user Microsoft sign-in, so Claude can reach To Do from web, mobile and scheduled tasks without a local process. See worker/README.md.
Prerequisites
Node.js 16 or higher (tested with Node.js 18.x, 20.x, and 22.x)
A Microsoft account (personal, work, or school)
Azure App Registration (see setup below)
Installation
Quickstart with npx (Recommended)
No installation needed — just configure Claude Desktop to run the server via npx:
{
"mcpServers": {
"microsoftTodo": {
"command": "npx",
"args": ["--yes", "mstodo-mcp-server@latest"],
"env": {
"ACCESS_TOKEN": "your_access_token",
"REFRESH_TOKEN": "your_refresh_token",
"CLIENT_ID": "your_client_id",
"CLIENT_SECRET": "your_client_secret",
"TENANT_ID": "your_tenant_id"
}
}
}
}Global Installation
npm install -g mstodo-mcp-serverThe package provides these command aliases:
mstodo-mcp-server— main entry point (matches package name for npx)mstodo— short aliasmstodo-config— configuration helpermstodo-setup— guided setup wizard
Clone and Run Locally
git clone https://github.com/neelroy/microsoft-todo-mcp-server.git
cd microsoft-todo-mcp-server
pnpm install
pnpm run buildAzure App Registration
Go to the Azure Portal
Navigate to App registrations → New registration
Name your application (e.g., "TodoMCP")
Choose the appropriate account type for your needs
Set the Redirect URI to
http://localhost:3000/callbackUnder Certificates & secrets, create a new client secret
Under API permissions, add Microsoft Graph delegated permissions:
Tasks.ReadTasks.ReadWriteTasks.Read.SharedTasks.ReadWrite.SharedUser.Read
Click Grant admin consent
Configuration
Environment Variables
Variable | Description |
| Microsoft Graph access token |
| Refresh token for automatic renewal |
| Azure App Registration client ID |
| Azure App Registration client secret |
| Tenant ID or |
| Custom path for |
TENANT_ID Options
TENANT_ID=organizations # Work/school accounts (multi-tenant)
TENANT_ID=consumers # Personal Microsoft accounts only
TENANT_ID=common # Both work and personal accounts
TENANT_ID=00000000-0000-0000-0000-000000000000 # Single tenantAuthentication Flow
Run the auth server to obtain tokens interactively:
pnpm run auth # Opens browser for Microsoft login, writes tokens.json
pnpm run create-config # Generates mcp.json from tokens.jsonTokens are automatically refreshed 5 minutes before expiration.
Claude Desktop Setup
Edit your Claude Desktop config file:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"microsoftTodo": {
"command": "npx",
"args": ["--yes", "mstodo-mcp-server@latest"],
"env": {
"ACCESS_TOKEN": "your_access_token",
"REFRESH_TOKEN": "your_refresh_token",
"CLIENT_ID": "your_client_id",
"CLIENT_SECRET": "your_client_secret",
"TENANT_ID": "your_tenant_id"
}
}
}
}Restart Claude Desktop after saving. The server will be downloaded and started automatically.
MCP Tools
Authentication
Tool | Description |
| Check token status and expiration |
Task Lists
Tool | Description |
| All lists with metadata; supports |
| Lists grouped by naming pattern, emoji prefix, and sharing status |
| Create a new list |
| Rename a list |
| Delete a list and all its tasks |
Tasks
Tool | Description |
| Tasks from a list with OData support: |
| Create a task (title, body, due date, importance, reminder, categories) |
| Update any task properties |
| Delete a task and its checklist items |
Task output includes:
Title, status (○ / ✓), importance, due date
createdDateTime— when the task was addedlastModifiedDateTime, body preview, categories, attachments flag
Checklist Items (Subtasks)
Tool | Description |
| Get subtasks for a task |
| Add a subtask |
| Update subtask text or completion |
| Remove a subtask |
Bulk Operations
Tool | Description |
| Move completed tasks older than N days to an archive list. Supports |
Graph API Notes
The Microsoft Graph todoTask API has some quirks worth knowing:
titleis not selectable: Passingtitlein$selectreturns a 400 error, but the API always returns it anyway. The server handles this automatically.$filteroncreatedDateTimeis unsupported: Use$orderby=createdDateTime descand filter client-side.Complex types can't be in
$select: Fields likerecurrenceandstartDateTimeare excluded from the default select.
Architecture
src/
├── todo-index.ts # MCP server — all 16 tools
├── cli.ts # CLI entry point with token loading
├── auth-server.ts # OAuth 2.0 / MSAL auth flow (port 3000)
├── create-mcp-config.ts # Generates mcp.json from tokens.json
├── setup.ts # Guided setup wizard
└── token-manager.ts # Token refresh logicBuild system: tsup — version is auto-injected from package.json at build time.
Development
pnpm install
pnpm run build # Compile TypeScript → dist/
pnpm run dev # Build + run CLI
pnpm run auth # Start OAuth server on :3000
pnpm run typecheck # Type check without building
pnpm run format # Format with PrettierLimitations
Personal Microsoft Accounts
Personal accounts (outlook.com, hotmail.com, live.com) may encounter MailboxNotEnabledForRESTAPI errors. This is a Microsoft service limitation — work/school accounts have full API access.
API Limits
Standard Microsoft Graph rate limits apply
$filtersupport ontodoTaskis limited (status, importance, dueDateTime work; createdDateTime does not)
Troubleshooting
could not determine executable to run — The npx cache may have a stale version. Clear it:
rm -rf ~/.npm/_npxThen restart Claude Desktop.
Token expired errors — Tokens auto-refresh, but if the refresh token itself expires, re-run pnpm run auth.
RequestBroker--ParseUri from Graph API — Usually caused by invalid field names in $select. The server's default select list is pre-validated against the API.
License
MIT License — See LICENSE file for details.
Acknowledgments
Fork of @jhirono/todomcp via jordanburke/microsoft-todo-mcp-server
Built on the Model Context Protocol SDK
Uses Microsoft Graph API
Links
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Task management for people and AI agents, with scoped OAuth access to issues, projects, and docs.
Task management for people and AI agents, with scoped OAuth access to issues, projects, and docs.
AI-powered to-do list: add, list, complete and organise tasks across lists from any assistant.
AI-native task management: list, create, update and archive tasks with rich context for AI agents
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables 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.-
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to manage Microsoft To Do tasks via the Graph API, supporting multiple accounts, encrypted auth, and full CRUD operations.9 npm2MIT

graphdo-tsofficial
AlicenseAqualityDmaintenanceEnables AI agents to send emails and manage tasks in Microsoft To Do with scoped, low-risk access to Microsoft Graph.34 npm1MIT- AlicenseNot gradedqualityCmaintenanceEnables coding agents to manage Microsoft To Do lists and tasks through Microsoft Graph, with optional support for checklist items, linked resources, attachments, and delta synchronization.200 npm1MIT