Microsoft Todo MCP Server
MCP server giving AI assistants read and write access to Microsoft To Do via Graph
- Pricing
- Open source
- Platforms
- CLI, self-hosted, API
- Runs
- Locally
- Version
- 1.5.4
- Listing updated
- today
Similar MCP servers
About Microsoft Todo MCP Server
Microsoft Todo MCP Server is an open-source MCP server for productivity. It runs locally on your machine and is started by your AI client.
The README describes this as a Model Context Protocol server that lets clients such as Claude and Cursor manage Microsoft To Do lists, tasks and checklist items through the Microsoft Graph API. Setup means registering an Azure app, signing in once to produce a token file, and pointing the assistant at the npm package over stdio.
Beyond basic task CRUD, it adds recurring task rules (daily, weekly, monthly and yearly patterns), OData filtering and paging when reading tasks, grouping of lists into folders, and a tool to archive old completed tasks with a dry-run preview. Token renewal runs automatically when the server has client credentials; the README notes that tokens supplied only through environment variables do not renew.
The package also includes an HTTP mode for remote clients, where each user signs in with their own Microsoft account and tokens are kept in an encrypted store. It suits people who already use Microsoft To Do and want an AI assistant to work with it, particularly those comfortable managing an Azure app registration.
Install
Run in a terminal
claude 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_SECRET='<CLIENT_SECRET>' -- npx -y microsoft-todo-mcp-serverAdd to claude_desktop_config.json
{
"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_SECRET": "<CLIENT_SECRET>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"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_SECRET": "<CLIENT_SECRET>"
}
}
}
}Add to .vscode/mcp.json
{
"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_SECRET": "<CLIENT_SECRET>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"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_SECRET": "<CLIENT_SECRET>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"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_SECRET": "<CLIENT_SECRET>"
}
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
MS_TODO_ACCESS_TOKENMicrosoft Graph access token. Must be set together with MS_TODO_REFRESH_TOKEN; `mstodo-config` emits both.MS_TODO_REFRESH_TOKENRefresh token. Required alongside the access token, but note the env-token path does not renew: once the access token expires the server returns 401 until it is replaced.CLIENT_IDAzure AD application (client) ID. The server reads it to refresh tokens when the stored token file carries no credentials; `mstodo-setup` also uses it.CLIENT_SECRETAzure AD client secret, used for the same token refresh and by `mstodo-setup`.TENANT_IDAzure AD tenant: 'organizations' (the default), 'consumers', 'common', or a tenant GUID.
Tools this server provides (17)
Taken from the project documentation; the running server may differ.
- auth-status
- Check authentication status, token expiration, and account type
- info
- Report the server's name, version, build, runtime, and tool count
- get-task-lists
- Retrieve all task lists with metadata
- create-task-list
- Create a new task list
- update-task-list
- Rename an existing task list
- delete-task-list
- Delete a task list and all its contents
- get-task-lists-organized
- Group task lists into folders by naming pattern, emoji prefix, or sharing status
- get-tasks
- Get tasks from a list with filtering, sorting, and pagination
- create-task
- Create a new task with full property support
- update-task
- Update any task properties including recurrence
- delete-task
- Delete a task and all its checklist items
- get-checklist-items
- Get subtasks for a specific task
- create-checklist-item
- Add a new subtask to a task
- update-checklist-item
- Update subtask text or completion status
- delete-checklist-item
- Remove a specific subtask
- archive-completed-tasks
- Move completed tasks older than a set number of days to another list
- test-graph-api-exploration
- Run read-only Graph API probes to look for hidden list properties
What it does
- Full task management
- Create, read, update and delete task lists, tasks and checklist items through 17 MCP tools.
- Recurring task rules
- Set daily, weekly, monthly or yearly recurrence on tasks, and stop them by passing null.
- Filtered task queries
- Read tasks with OData filter, sort and paging options, with the server following Graph pages.
- Automatic token renewal
- Refreshes access tokens before expiry when client credentials are available.
- Remote HTTP mode
- Optional streamable HTTP server where each user signs in with their own Microsoft account.
- Archive completed tasks
- Moves old completed tasks to another list, with a dry-run option to preview changes.
Good for
- Let an AI assistant add, rename or complete Microsoft To Do items during a chat
- Set recurring bills, standups or birthdays as Microsoft To Do tasks from natural language
- Clean up a long task list by archiving completed items older than a chosen number of days
- Organise many task lists into folders by name, emoji prefix or sharing status
Pricing
Open source
Open source under the MIT licence; the separate hosted Agent Todo service has its own free and Pro plans.
Microsoft Todo MCP Server FAQ
Does it work with personal Microsoft accounts?
Yes. The README says personal accounts such as outlook.com, hotmail.com and live.com work, with the TENANT_ID set to consumers or common.
Do I need to register an Azure app?
For this self-run server, yes. The README walks through creating an app registration and client secret. It also mentions a hosted alternative, Agent Todo, that avoids this step.
What happens when the access token expires if I only use environment variables?
The README says the env-token path does not renew, so the server returns 401 until the token is replaced, unless CLIENT_ID and CLIENT_SECRET are also set.
Which Node.js version is required?
The README lists Node.js 22.18 or higher as a prerequisite.
Is Microsoft Todo MCP Server free?
Yes. Microsoft Todo MCP Server is open source, so you can use and self-host it for free.
How do I add Microsoft Todo MCP Server to Claude Code?
Run this command in your terminal: claude 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_SECRET='<CLIENT_SECRET>' -- npx -y microsoft-todo-mcp-server
What are the best alternatives to Microsoft Todo MCP Server?
The closest alternatives to Microsoft Todo MCP Server are MCP Microsoft Todo, To-do Calendar, Todoist, GetItDone and Taskade MCP.
Where this comes from
- Description: written from the project's README and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.
