# mcp-microsoft-todo

Connects Microsoft To Do to AI coding tools through Microsoft Graph. It lets your assistant check daily agendas, update checklists, and organize task lists.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 18
- Author: MAG-Cie
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/MAG-Cie/mcp-microsoft-todo
- Updated: 2026-05-11
- HTML: https://affpapa.org/en/nevibecode/mcp/mcp-microsoft-todo

## What it does

The server communicates over standard I/O to link coding agents with Microsoft Graph. Authentication relies on MSAL device code flow. Running the authorization generates a short code and an official Microsoft login URL. Once approved in a browser, credentials stay cached in `~/.mcp-microsoft-todo/token-cache.json` for subsequent calls.

The tool exposes distinct functions for task operations. You can pull today's summary, search entries by keyword, move tasks between lists, and set up recurrence. It also supports batch completion, category tagging, and exporting task data into iCalendar `.ics` files.

Node.js 20 or higher is required. For personal accounts on outlook.com or hotmail.com, you must pass `MS_TENANT=consumers` or authentication will fail.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `MS_CLIENT_ID`, `MS_TENANT` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env MS_CLIENT_ID=<MS_CLIENT_ID> --env MS_TENANT=<MS_TENANT> --transport stdio mcp-microsoft-todo -- npx -y @mag-cie/mcp-microsoft-todo
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add mcp-microsoft-todo --env MS_CLIENT_ID=<MS_CLIENT_ID> --env MS_TENANT=<MS_TENANT> -- npx -y @mag-cie/mcp-microsoft-todo
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp-microsoft-todo": {
            "command": "npx",
            "args": [
                "-y",
                "@mag-cie/mcp-microsoft-todo"
            ],
            "env": {
                "MS_CLIENT_ID": "<MS_CLIENT_ID>",
                "MS_TENANT": "<MS_TENANT>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp-microsoft-todo": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@mag-cie/mcp-microsoft-todo"
            ],
            "env": {
                "MS_CLIENT_ID": "<MS_CLIENT_ID>",
                "MS_TENANT": "<MS_TENANT>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e MS_CLIENT_ID=<MS_CLIENT_ID> -e MS_TENANT=<MS_TENANT> mcp-microsoft-todo npx -y @mag-cie/mcp-microsoft-todo
```
Replace <…> with your own values

## When to use it
- review overdue tasks and today's schedule from Microsoft To Do
- create recurring tasks with nested checklist items
- complete multiple tasks simultaneously in a batch
- export work tasks into iCalendar format

## Example prompts
- Show me my overdue tasks in Microsoft To Do
- Create a daily recurring task named 'Review PRs' in my Work list
- Find all tasks containing 'invoice' and mark them as done

## Similar
- [Reactive Resume](https://affpapa.org/en/nevibecode/mcp/reactive-resume.md) — MCP server · ★ 44874
- [screenpipe](https://affpapa.org/en/nevibecode/mcp/screenpipe.md) — MCP server · ★ 22053
- [Inbox Zero](https://affpapa.org/en/nevibecode/mcp/inbox-zero.md) — MCP server · ★ 12791
- [kaneo](https://affpapa.org/en/nevibecode/mcp/kaneo.md) — MCP server · ★ 9602
- [Mindwtr](https://affpapa.org/en/nevibecode/mcp/mindwtr.md) — MCP server · ★ 2318
- [Azure DevOps (ADO)](https://affpapa.org/en/nevibecode/mcp/azure-devops-ado.md) — MCP server · ★ 2067

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md