Skip to content
MCP server

Microsoft Todo MCP Server

MCP server giving AI assistants read and write access to Microsoft To Do via Graph

Runs locallyStatus and history
Install
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-server

Add 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.

How AIPoweredBot checks servers