wecom-todo

name	wecom-todo
description	企业微信待办事项管理技能，支持查询待办列表、获取待办详情、创建待办、更新待办、删除待办及变更用户处理进度状态。在用户说"看看我的待办列表"、"我有哪些待办"、"帮我创建一个待办"、"把这个任务分派给张三"、"标记待办完成"、"删掉那个待办"、"帮我建个提醒"、"更新一下待办内容"、"把提醒时间改到下周"、"接受这个待办"、"拒绝这个待办"、"这个待办的详情"、"待办分派给谁了"等需要对待办进行读写操作的场景时使用。

企业微信待办事项管理技能

wecom_mcp 是一个 MCP tool，所有操作通过调用该 tool 完成。

⚠️ 前置条件：首次调用 wecom_mcp 前，必须按 wecom-preflight 技能执行前置条件检查，确保工具已加入白名单。

概述

wecom-todo 提供企业微信待办事项的完整管理能力，包含以下功能：

1. 查询待办列表 - 按创建时间和提醒时间过滤，支持分页，返回待办概要信息
2. 获取待办详情 - 根据待办 ID 列表批量获取完整信息（含内容和分派人）
3. 创建待办 - 创建新的待办事项，可指定内容、分派人和提醒时间
4. 更新待办 - 修改已有待办的内容、分派人、状态或提醒时间
5. 删除待办 - 删除指定的待办事项
6. 变更用户待办状态 - 更改当前用户在某个待办中的状态（拒绝/接受/已完成）

命令调用方式

使用 wecom_mcp tool 调用 wecom_mcp call todo <tool_name> '<json格式的入参>'

行为策略

查完列表必须查详情: get_todo_list 只返回待办 ID 和状态等概要信息，不包含待办的实际内容和分派人。对用户来说，没有内容的待办列表毫无用处——他们想知道的是"要做什么"，而不是一串 ID。因此，每次调用 get_todo_list 拿到结果后，都要紧接着用返回的 todo_id 列表调用 get_todo_detail 获取完整详情（内容、分派人等），然后再向用户展示。这不是可选步骤，而是完成用户请求的必要环节。

人员 ID 转姓名（关键步骤）: get_todo_detail 返回结果中的 follower_id 和 creator_id 都是系统内部 ID，直接展示给用户毫无意义——用户不认识这些 ID，只认识姓名。因此在向用户展示待办详情之前，必须先调用 wecom-contact 技能获取通讯录，将所有 follower_id 和 creator_id 匹配为真实姓名。具体做法：

使用 wecom_mcp tool 调用 wecom_mcp call contact get_userlist '{}' 获取通讯录，在返回的 userlist 中，用 userid 字段匹配 follower_id / creator_id，取对应的 name。

如果通讯录中找不到某个 ID，展示时标注"未知用户(ID: xxx)"即可。

分页未拉完时必须提醒用户: get_todo_list 接口是分页的，不要求一次性拉完所有数据。但如果响应中 has_more 为 true，说明后面还有待办没有返回——这时你在展示当前结果的同时，必须明确告诉用户"还有更多待办未显示，是否需要继续查看？"。用户可能不知道后面还有数据，如果你不说，他们会以为看到的就是全部，这会导致遗漏重要待办。这是一个容易被忽略但后果严重的点，请务必执行。

重试策略: 遭遇"返回 HTTP 错误"或"HTTP 请求失败"时，主动重试，最多重试三次。

---

命令详细说明

1. 查询待办列表 (get_todo_list)

查询当前用户的待办列表，支持按时间过滤和分页。返回的是待办概要信息（不含内容和分派人）。

调用方式

使用 wecom_mcp tool 调用 wecom_mcp call todo get_todo_list '<json格式的入参>'

入参说明

参数	类型	必填	说明
create_begin_time	string	❌	创建开始时间，格式：YYYY-MM-DD HH:mm:ss
create_end_time	string	❌	创建结束时间，格式：YYYY-MM-DD HH:mm:ss
remind_begin_time	string	❌	提醒开始时间，格式：YYYY-MM-DD HH:mm:ss
remind_end_time	string	❌	提醒结束时间，格式：YYYY-MM-DD HH:mm:ss
limit	number	❌	最大返回数量，默认 10，最大 20
cursor	string	❌	分页游标，首次请求不传，后续传入上次响应的 next_cursor

返回格式

{
    "errcode": 0,
    "errmsg": "ok",
    "index_list": [
        {
            "todo_id": "TODO_ID",
            "todo_status": 1,
            "user_status": 1,
            "creator_id": "CREATOR_ID",
            "remind_time": "2025-06-01 09:00:00",
            "create_time": "2025-01-15 10:30:00",
            "update_time": "2025-01-16 14:20:00"
        }
    ],
    "next_cursor": "NEXT_CURSOR",
    "has_more": false
}

返回字段说明

字段	类型	说明
index_list	array	待办列表
index_list[].todo_id	string	待办唯一 ID
index_list[].todo_status	number	待办状态：0-已完成，1-进行中，2-已删除
index_list[].user_status	number	用户状态：0-拒绝，1-接受，2-已完成
index_list[].creator_id	string	创建人 ID
index_list[].remind_time	string	提醒时间
index_list[].create_time	string	创建时间
index_list[].update_time	string	更新时间
next_cursor	string	下一页游标
has_more	boolean	是否还有更多记录

列表返回的是待办概要信息（不含内容和分派人）。拿到列表后，必须调用 get_todo_detail 获取完整详情再展示给用户。

---

2. 获取待办详情 (get_todo_detail)

根据待办 ID 列表批量查询完整详情，包含待办内容和分派人信息。

调用方式

使用 wecom_mcp tool 调用 wecom_mcp call todo get_todo_detail '<json格式的入参>'

入参说明

参数	类型	必填	说明
todo_id_list	array	✅	待办 ID 列表，最多 20 个

调用示例

使用 wecom_mcp tool 调用 wecom_mcp call todo get_todo_detail '{"todo_id_list": ["TODO_ID_1", "TODO_ID_2"]}'

返回格式

{
    "errcode": 0,
    "errmsg": "ok",
    "data_list": [
        {
            "todo_id": "TODO_ID",
            "todo_status": 1,
            "content": "完成Q2规划文档",
            "follower_list": {
                "followers": [
                    {
                        "follower_id": "FOLLOWER_ID",
                        "follower_status": 1,
                        "update_time": "2025-01-16 14:20:00"
                    }
                ]
            },
            "creator_id": "CREATOR_ID",
            "user_status": 1,
            "remind_time": "2025-06-01 09:00:00",
            "create_time": "2025-01-15 10:30:00",
            "update_time": "2025-01-16 14:20:00"
        }
    ]
}

返回字段说明

字段	类型	说明
data_list	array	待办详情列表，最多 20 条
data_list[].todo_id	string	待办 ID
data_list[].todo_status	number	待办状态：0-已完成，1-进行中，2-已删除
data_list[].content	string	待办内容
data_list[].follower_list.followers	array	分派人列表
data_list[].follower_list.followers[].follower_id	string	分派人 ID（即 userid）— 展示前需通过 wecom-contact 转为姓名
data_list[].follower_list.followers[].follower_status	number	分派人状态：0-拒绝，1-接受，2-已完成
data_list[].follower_list.followers[].update_time	string	分派人状态更新时间
data_list[].creator_id	string	创建人 ID — 展示前需通过 wecom-contact 转为姓名
data_list[].user_status	number	当前用户状态
data_list[].remind_time	string	提醒时间
data_list[].create_time	string	创建时间
data_list[].update_time	string	更新时间

---

3. 创建待办 (create_todo)

创建一个新的待办事项，可指定内容、分派人和提醒时间。

调用方式

使用 wecom_mcp tool 调用 wecom_mcp call todo create_todo '<json格式的入参>'

入参说明

参数	类型	必填	说明
content	string	✅	待办内容
follower_list	object	❌	分派人列表，格式见注意事项第 6 条
remind_time	string	❌	提醒时间，格式：YYYY-MM-DD HH:mm:ss

调用示例

使用 wecom_mcp tool 调用 wecom_mcp call todo create_todo '{"content": "<待办的内容>", "remind_time": "2025-06-01 09:00:00"}'

返回格式

{
    "errcode": 0,
    "errmsg": "ok",
    "todo_id": "TODO_ID"
}

返回字段说明

字段	类型	说明
todo_id	string	新创建的待办唯一 ID

---

4. 更新待办 (update_todo)

修改已有待办事项的内容、分派人、状态或提醒时间。

调用方式

使用 wecom_mcp tool 调用 wecom_mcp call todo update_todo '<json格式的入参>'

入参说明

参数	类型	必填	说明
todo_id	string	✅	待办 ID
content	string	❌	新的待办内容
follower_list	object	❌	新的分派人列表（全量替换，非追加），格式见注意事项第 6 条。若要新增分派人，需先查出现有分派人，合并后一起提交
todo_status	number	❌	新的待办状态：0-已完成，1-进行中，2-已删除。删除请使用 delete_todo
remind_time	string	❌	新的提醒时间

调用示例

使用 wecom_mcp tool 调用 wecom_mcp call todo update_todo '{"todo_id": "TODO_ID", "content": "<待办的内容>", "remind_time": "2025-07-01 09:00:00"}'

返回格式

{
    "errcode": 0,
    "errmsg": "ok"
}

---

5. 删除待办 (delete_todo)

删除指定的待办事项。

调用方式

使用 wecom_mcp tool 调用 wecom_mcp call todo delete_todo '<json格式的入参>'

入参说明

需要遵循 “注意事项”中的格式要求：

参数	类型	必填	说明
todo_id	string	✅	待办 ID

调用示例

使用 wecom_mcp tool 调用 wecom_mcp call todo delete_todo '{"todo_id": "TODO_ID"}'

返回格式

{
    "errcode": 0,
    "errmsg": "ok"
}

删除前必须向用户确认，确认措辞示例："确认删除待办'代码评审'吗？删除后不可恢复。" 注意：delete_todo 与 update_todo 设置 todo_status=2 效果相同，优先使用 delete_todo。

---

6. 变更用户待办状态 (change_todo_user_status)

更改当前用户在某个待办中的状态（拒绝/接受/已完成）。

调用方式

使用 wecom_mcp tool 调用 wecom_mcp call todo change_todo_user_status '<json格式的入参>'

入参说明

需要遵循 “注意事项”中的格式要求：

参数	类型	必填	说明
todo_id	string	✅	待办 ID
user_status	number	✅	用户状态：0-拒绝，1-接受，2-已完成

调用示例

使用 wecom_mcp tool 调用 wecom_mcp call todo change_todo_user_status '{"todo_id": "TODO_ID", "user_status": 2}'

返回格式

{
    "errcode": 0,
    "errmsg": "ok"
}

返回字段说明

字段	类型	说明
errcode	number	返回码，0 表示成功