# Microsoft Todo MCP Server

> Microsoft Todo MCP Server is an open-source MCP server for productivity. MCP server giving AI assistants read and write access to Microsoft To Do via Graph. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, API
- **Repository:** https://github.com/jordanburke/microsoft-todo-mcp-server
- **MCP Registry name:** io.github.jordanburke/microsoft-todo-mcp-server
- **Categories:** [productivity](https://ai-powered.com/categories/productivity)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
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
```

### Claude Desktop (claude_desktop_config.json)

```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>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```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>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```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>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```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>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```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>"
      }
    }
  }
}
```

## Tools

- `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

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

## Alternatives

- [MCP Microsoft Todo](https://ai-powered.com/mcp/mcp-microsoft-todo): MCP Microsoft Todo is an open-source MCP server for productivity.
- [To-do Calendar](https://ai-powered.com/mcp/to-do-calendar): To-do Calendar is an MCP server for productivity.
- [Todoist](https://ai-powered.com/mcp/todoist-2): Todoist is a freemium MCP server for productivity.
- [GetItDone](https://ai-powered.com/mcp/getitdone): GetItDone is a freemium MCP server for productivity.
- [Taskade MCP](https://ai-powered.com/mcp/taskade-mcp): Taskade MCP is a freemium MCP server for productivity.
- [ultra-e2e-test tasks](https://ai-powered.com/mcp/ultra-e2e-test-tasks): ultra-e2e-test tasks is an open-source MCP server for productivity.
- [Microsoft 365 MCP Server](https://ai-powered.com/mcp/microsoft-365-mcp-server): Microsoft 365 MCP Server is an open-source MCP server for productivity.
- [DoDo](https://ai-powered.com/mcp/dodo): DoDo is a free MCP server for productivity.

---
Source: https://ai-powered.com/mcp/microsoft-todo-mcp-server
