wecomcli-get-todo-list

Query WeCom todo lists with time filters and cursor-based pagination via CLI.

3|Updated Apr 2, 2026
One-click install
npx skills add https://github.com/Liangdi/wecom-pro --skill wecomcli-get-todo-list-liangdi
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: wecomcli-get-todo-list
Source: https://github.com/Liangdi/wecom-pro/tree/main/skills/wecomcli-get-todo-list
Command: npx skills add https://github.com/Liangdi/wecom-pro --skill wecomcli-get-todo-list-liangdi

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires wecom-pro.

What problem does it solve? It lets AI agents and terminal users retrieve an overview of WeCom (Enterprise WeChat) todo items without opening the app, supporting time-range filtering and paginated browsing of large todo backlogs. ## Core Features & Use Cases - Filtered Todo Queries: Filter todos by creation time or reminder time using YYYY-MM-DD HH:mm:ss ranges. - Cursor Pagination: Page through large todo lists with limit, cursor, next_cursor, and has_more controls. - Multi-Bot Support: Query different WeCom bots (e.g., work vs. personal) via the --bot flag. - Use Case: When a user asks "what todos do I have this week?", the agent queries the list, then must call the todo detail API with the returned IDs to show actual content, and must warn the user if has_more indicates additional pages. ## Quick Start Ask the agent to list your recent WeCom todos, for example by saying "show me my todo list for this month".

Frequently Asked Questions about wecomcli-get-todo-list

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I list my WeCom todos from the command line?▼

Run wecom-pro todo get_todo_list with a JSON argument, optionally including create or remind time filters. The command returns todo IDs and statuses; call get_todo_detail with those IDs to see actual todo content.

How to filter WeCom todos by date range?▼

Pass create_begin_time/create_end_time or remind_begin_time/remind_end_time in YYYY-MM-DD HH:mm:ss format inside the JSON argument. For example, set remind_begin_time and remind_end_time to cover a specific month.

Why does the todo list not show todo content or assignees?▼

The get_todo_list API only returns summary fields like todo_id, status, and timestamps by design. You must call wecomcli-get-todo-detail with the returned todo_id list to retrieve content and assignee information.

How do I paginate through a large WeCom todo list?▼

Set limit up to 20 and check has_more in the response. When true, pass the returned next_cursor as the cursor parameter in the next request, keeping time filters unchanged, until has_more becomes false.

Can I query todos from multiple WeCom bots?▼

Yes, use the --bot flag with a configured bot ID, such as wecom-pro todo --bot work get_todo_list. Without the flag, the default bot is used, so single-bot users need no extra configuration.