Microsoft To Do MCP
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Microsoft To Do MCP 今天加两个任务:写周报、给导师发邮件"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Microsoft To Do MCP
一个 MCP 服务,让 Claude 等 AI 客户端读写你的 Microsoft To Do。你可以直接说“今天加个任务:写周报”“把写周报标记完成”,由 AI 调用对应的工具完成。
主要特点:
用任务标题和列表名操作,不需要先查 id
个人微软账号不用注册 Azure 应用,登录一次即可
输出为中文,日期支持 today、明天、
HH:mm等写法请求带超时和重试,能防止重复创建;可以开启只读或禁止删除模式
快速开始
需要 Node.js ≥ 20 和 Git。本项目不发布到 npm,直接从 GitHub 安装,首次运行时会自动下载并编译,所以会慢一些。
1. 登录微软账号(只需一次)
npx -y github:hechen-coder/microsoft-todo-mcp login终端会显示一个网址和验证码。在浏览器打开网址,输入验证码,用 To Do 的账号登录。授权页面上申请权限的应用叫 “Microsoft Graph Command Line Tools”,点“接受”。之后令牌会自动续期。
2. 接入 Claude Code
Windows:
claude mcp add todo --scope user -- cmd /c npx -y github:hechen-coder/microsoft-todo-mcpmacOS / Linux:
claude mcp add todo --scope user -- npx -y github:hechen-coder/microsoft-todo-mcp重启 Claude Code 会话后生效。
Claude Desktop 在 claude_desktop_config.json 中添加下面的配置。Windows 下把 command 改为 cmd,并在 args 开头加上 "/c", "npx"。
{
"mcpServers": {
"todo": {
"command": "npx",
"args": ["-y", "github:hechen-coder/microsoft-todo-mcp"]
}
}
}第 1 步也可以跳过:接入后让 Claude 调用 login 工具,它会把网址和验证码告诉你。
常用说法举例:
“今天加两个任务:写周报、给导师发邮件”
“把写周报标记完成”
“今天还有哪些任务没做?”
“把写周报的第 2 步勾掉”
Related MCP server: Microsoft To Do MCP Server
工具列表
工具 | 作用 |
| 查看登录状态 / 设备码登录 |
| 列出 / 新建列表 |
| 列出某个列表的任务(默认“任务”列表,只看未完成) |
| 跨列表按关键字搜索 |
| 今天截止或已逾期的未完成任务 |
| 读取“我的一天”(仅 Windows,见下文) |
| 新建任务,可设截止日期、重要、备注、提醒 |
| 批量新建今天截止的任务 |
| 添加 / 查看子步骤 |
| 勾选、取消勾选或改写子步骤,可用序号(如“第2步”)、文字或 id 指定 |
| 删除子步骤 |
| 勾选 / 取消勾选任务,按标题模糊匹配或 id |
| 修改标题、截止日期、重要性、备注、提醒 |
| 永久删除任务 |
工作原理
flowchart LR
U["你:把写周报标记完成"] --> C["Claude 等 MCP 客户端"]
C -- "MCP 协议(stdio)<br/>调用 complete_task" --> S["本服务"]
S -- "HTTPS + 访问令牌" --> G["Microsoft Graph API<br/>(微软云端)"]
G -- "自动同步" --> A["Microsoft To Do 应用"]
S -. "只读,仅 get_my_day" .-> D[("本机 To Do 缓存库")]客户端启动本服务,本服务告诉 AI 自己提供哪些工具、需要哪些参数。
你用自然语言下指令,AI 决定调用哪个工具,比如
complete_task。本服务用你的授权令牌调用微软官方的 Graph API,修改云端数据。
To Do 应用从云端同步,几秒后显示变化。
所有修改都发生在云端,而不是直接改本机应用。本机 To Do 应用没有对外接口,它的数据只是云端的同步缓存,直接改它的数据库可能和同步冲突。这也意味着,To Do 应用要能正常同步,修改才会在应用里显示。
登录和授权
任务数据存在你的微软账号下,程序读写之前要先得到你的授权。本项目使用 OAuth 设备码流程:
login向微软申请一个设备码;你在浏览器里登录微软账号,确认授权“读写任务”;
微软把访问令牌发给本程序,之后调用 API 时都带上它;
令牌缓存在
%APPDATA%\todo-mcp\msal-cache.json(macOS / Linux 为~/.config/todo-mcp/),过期后自动续期。
程序拿不到你的密码,拿到的令牌只能读写任务和读取账号基本资料。
⚠
msal-cache.json能直接访问你的任务,不要分享或上传。退出登录:npx -y github:hechen-coder/microsoft-todo-mcp logout;彻底撤销授权:到 https://account.live.com/consent/Manage 移除 “Microsoft Graph Command Line Tools”。
关于“我的一天”
Graph API 不提供“我的一天”的数据,因此有两点限制:
add_today_task只能把截止日期设为今天。任务会出现在“计划内”,并作为“我的一天”的建议,但不会直接加进“我的一天”。get_my_day通过只读方式读取本机 To Do 应用的缓存库来获得“我的一天”,所以只在安装了 To Do 应用的 Windows 上可用,并且需要 Node.js ≥ 22.5。它不会写入这个数据库。
常见问题
To Do 应用一直同步失败(左上角显示橙色圆点)
如果系统代理指向本机(例如 Clash 的 127.0.0.1:7890),Windows 默认不允许 Microsoft Store 应用连接 127.0.0.1,To Do 就无法同步。用管理员终端执行下面的命令,然后重启 To Do:
CheckNetIsolation LoopbackExempt -a -n="Microsoft.Todos_8wekyb3d8bbwe"使用自己的 Azure 应用,或工作 / 学校账号
注册一个 Azure 应用:账户类型包含个人帐户,开启“允许公共客户端流”,添加委托权限 Tasks.ReadWrite 和 User.Read。然后用应用的 Client ID 登录:
npx -y github:hechen-coder/microsoft-todo-mcp login <你的ClientID>工作或学校账号还需要设置环境变量 TODO_TENANT=organizations。
环境变量(可选)
变量 | 说明 |
| 自定义 Azure 应用的 Client ID |
| 默认 |
| 截止和提醒时间使用的时区,默认取系统时区 |
| 手动指定 To Do 本地缓存库 |
| 设为 |
| 设为 |
| 单次请求的超时时间,默认 15000 |
| 防重复创建的时间窗口,默认 60 秒 |
例如以只读方式接入:
claude mcp add todo-ro -e TODO_READONLY=1 -- cmd /c npx -y github:hechen-coder/microsoft-todo-mcp可靠性设计
超时与重试:每个请求最多等 15 秒。遇到 429、503、504 时,按服务端给的
Retry-After或逐次加长的间隔重试,最多 3 次。查询、修改、删除请求在超时或断网时也会重试;新建请求不会,因为它可能已经生效,重试会建出重复任务。防重复创建:
add_task、add_today_task、add_step、create_list在 60 秒内收到参数完全相同的请求时,直接返回上次的结果。服务重启后这个记录会清空。风险分级:每个工具都标注了 MCP
annotations(readOnlyHint/destructiveHint),客户端可以据此决定执行前是否询问你。
本地开发
git clone https://github.com/hechen-coder/microsoft-todo-mcp.git
cd microsoft-todo-mcp
npm install
npm run build
npm run login
claude mcp add todo-dev -- node /绝对路径/microsoft-todo-mcp/dist/cli.js同类项目
License
Available Tools
18 toolsadd_stepB
给任务添加一个子步骤(checklist)
Inputs: step (required), list, title, taskId.
add_taskC
新建一个任务
Inputs: title (required), due, list, note, +2 more.
add_today_taskA
快捷新增“今天的任务”:截止日期设为今天,会出现在“计划内”,并作为“我的一天”的建议。可一次添加多个。(Graph API 无法直接加入“我的一天”列表)
Inputs: titles (required), list, reminder, important.
auth_statusARead-only
查看 Microsoft To Do 的登录状态和当前账号
Inputs: no named parameters.
complete_taskB
把任务标记为已完成(勾选)
Inputs: list, title, taskId.
create_listC
新建一个 To Do 列表
Inputs: name (required).
delete_stepADestructive
删除任务的某个子步骤(不可恢复)。只有在用户明确要求删除时才调用。
Inputs: step (required), list, title, taskId.
delete_taskADestructive
永久删除任务(不可恢复)。只有在用户明确要求删除时才调用。
Inputs: list, title, taskId.
get_my_dayARead-only
读取 To Do 桌面应用中“我的一天”的任务(从本机缓存只读读取,Graph API 不提供此数据)。标注“未同步”的任务只存在于本机,暂时无法通过其他工具修改。
Inputs: date.
get_today_tasksARead-only
列出所有列表中截止日期为今天(或已逾期)的未完成任务
Inputs: no named parameters.
list_listsCRead-only
列出所有 To Do 列表
Inputs: no named parameters.
list_stepsBRead-only
查看任务的所有子步骤及其勾选状态
Inputs: list, title, taskId.
list_tasksCRead-only
列出某个列表中的任务
Inputs: list, status.
loginARead-only
用设备码方式登录 Microsoft 账号。返回一个网址和验证码,需要把它们原样告诉用户,让用户在浏览器中完成登录;登录完成后再调用其他工具。
Inputs: no named parameters.
search_tasksARead-only
按关键字在所有列表(或指定列表)中搜索任务
Inputs: query (required), list, status.
uncomplete_taskB
取消任务的完成状态(取消勾选)
Inputs: list, title, taskId.
update_stepB
勾选/取消勾选子步骤,或修改步骤文字。checked=true 勾选,false 取消勾选
Inputs: step (required), list, title, taskId, +2 more.
update_taskB
修改任务:标题、截止日期、重要性、备注、提醒。clear_due=true 可清除截止日期
Inputs: due, list, note, title, +5 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 18 tools
Most tools target distinct resources or actions, but the 'today' tools (get_today_tasks, get_my_day, add_today_task) and add_task vs add_today_task can be confused. Descriptions clarify the differences, so misselection is limited.
Nearly all tools use snake_case with a verb_noun pattern (list_tasks, add_step, update_task), which is predictable. Minor deviations like auth_status (noun_noun) and login (bare verb) are readable but not perfectly consistent.
18 tools is on the heavy side for a To Do client; several granular step tools and separate complete/uncomplete could be consolidated. The count is borderline but not excessive for the domain's sub-resources.
Task and step lifecycles are well covered, but list lifecycle is incomplete: create_list and list_lists exist with no update_list or delete_list. There is also no get_task for single-task detail retrieval, leaving notable gaps.
Maintenance
Related MCP Connectors
Manage Redbooth tasks, task lists, comments, tags and files from Claude and other AI assistants.
AI-powered to-do list: add, list, complete and organise tasks across lists from any assistant.
Manage Superlist tasks and lists in plain language from any MCP-compatible AI agent.
Lets Claude, ChatGPT, and Muse read and update your beckett tasks, notes, calendar, and lists.
Related MCP Servers
- AlicenseAqualityCmaintenanceConnects Microsoft To Do to Claude, enabling task fetching, planning, completion, note-taking, and checklist management through natural language.9MIT
- AlicenseAqualityCmaintenanceEnables AI clients like Claude to read and manage Microsoft To Do task lists and tasks via the Microsoft Graph API, running locally over stdio with secure token storage.10464 npmMIT
- AlicenseAqualityBmaintenanceEnables AI agents to read and edit Microsoft To Do tasks, lists, and steps via Microsoft Graph, including due dates, reminders, and subtasks.121MIT
- AlicenseBqualityBmaintenanceEnables Claude to create, read, update and delete Microsoft To Do lists, tasks and checklist items, and Microsoft Planner plans, buckets and tasks, through Microsoft Graph as the signed-in user. Lists, plans and buckets can be referenced by ID or exact name, with destructive deletes requiring confirmation.31MIT