todoist-automation

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Todoist Automation via Rube MCP

基于Rube MCP的Todoist自动化

Automate Todoist operations including task creation and management, project organization, section management, filtering, and bulk task workflows through Composio's Todoist toolkit.

通过Composio的Todoist工具包，自动化Todoist操作，包括任务创建与管理、项目组织、分区管理、筛选及批量任务工作流。

Prerequisites

前提条件

Rube MCP must be connected (RUBE_SEARCH_TOOLS available)
Active Todoist connection via
```
RUBE_MANAGE_CONNECTIONS
```
with toolkit
```
todoist
```
Always call
```
RUBE_SEARCH_TOOLS
```
first to get current tool schemas

必须已连接Rube MCP（需支持RUBE_SEARCH_TOOLS）
通过
```
RUBE_MANAGE_CONNECTIONS
```
并使用
```
todoist
```
工具包完成Todoist的激活连接
请始终先调用
```
RUBE_SEARCH_TOOLS
```
以获取最新的工具schema

Setup

设置步骤

Get Rube MCP: Add

https://rube.app/mcp

as an MCP server in your client configuration. No API keys needed — just add the endpoint and it works.

Verify Rube MCP is available by confirming
```
RUBE_SEARCH_TOOLS
```
responds
Call
```
RUBE_MANAGE_CONNECTIONS
```
with toolkit
```
todoist
```
If connection is not ACTIVE, follow the returned auth link to complete Todoist OAuth
Confirm connection status shows ACTIVE before running any workflows

获取Rube MCP：在客户端配置中添加

https://rube.app/mcp

作为MCP服务器。无需API密钥——只需添加端点即可使用。

确认
```
RUBE_SEARCH_TOOLS
```
能正常响应，以此验证Rube MCP是否可用
调用
```
RUBE_MANAGE_CONNECTIONS
```
并指定工具包为
```
todoist
```
如果连接状态未显示为ACTIVE，请按照返回的授权链接完成Todoist OAuth认证
在运行任何工作流之前，确认连接状态已显示为ACTIVE

Core Workflows

核心工作流

1. Create and Manage Tasks

1. 创建与管理任务

When to use: User wants to create, update, complete, reopen, or delete tasks

Tool sequence:

```
TODOIST_GET_ALL_PROJECTS
```
- List projects to find the target project ID [Prerequisite]
```
TODOIST_GET_ALL_SECTIONS
```
- List sections within a project for task placement [Optional]
```
TODOIST_CREATE_TASK
```
- Create a single task with content, due date, priority, labels [Required]
```
TODOIST_BULK_CREATE_TASKS
```
- Create multiple tasks in one request [Alternative]
```
TODOIST_UPDATE_TASK
```
- Modify task properties (content, due date, priority, labels) [Optional]
```
TODOIST_CLOSE_TASK
```
- Mark a task as completed [Optional]
```
TODOIST_REOPEN_TASK
```
- Restore a previously completed task [Optional]
```
TODOIST_DELETE_TASK
```
- Permanently remove a task [Optional]

Key parameters for CREATE_TASK:

```
content
```
: Task title (supports markdown and hyperlinks)
```
description
```
: Additional notes (do NOT put due dates here)
```
project_id
```
: Alphanumeric project ID; omit to add to Inbox
```
section_id
```
: Alphanumeric section ID for placement within a project
```
parent_id
```
: Task ID for creating subtasks
```
priority
```
: 1 (normal) to 4 (urgent) -- note: Todoist UI shows p1=urgent, API p4=urgent

due_string

: Natural language date like

"tomorrow at 3pm"

"every Friday at 9am"

```
due_date
```
: Specific date
```
YYYY-MM-DD
```
format
```
due_datetime
```
: Specific date+time in RFC3339
```
YYYY-MM-DDTHH:mm:ssZ
```
```
labels
```
: Array of label name strings
```
duration
```
+
```
duration_unit
```
: Task duration (e.g.,
```
30
```
+
```
"minute"
```
)

Pitfalls:

Only one
```
due_*
```
field can be used at a time (except
```
due_lang
```
which can accompany any)
Do NOT embed due dates in
```
content
```
or
```
description
```
-- use
```
due_string
```
field
Do NOT embed duration phrases like "for 30 minutes" in
```
due_string
```
-- use
```
duration
```
+
```
duration_unit
```
```
priority
```
in API: 1=normal, 4=urgent (opposite of Todoist UI display where p1=urgent)
Task IDs can be numeric or alphanumeric; use the format returned by the API
```
CLOSE_TASK
```
marks complete;
```
DELETE_TASK
```
permanently removes -- they are different operations

适用场景：用户需要创建、更新、完成、重新打开或删除任务

工具执行序列:

```
TODOIST_GET_ALL_PROJECTS
```
- 列出所有项目以找到目标项目ID [前提步骤]
```
TODOIST_GET_ALL_SECTIONS
```
- 列出项目内的分区，用于任务定位 [可选]
```
TODOIST_CREATE_TASK
```
- 创建单个任务，支持设置内容、截止日期、优先级、标签 [必填]
```
TODOIST_BULK_CREATE_TASKS
```
- 一次请求创建多个任务 [替代方案]
```
TODOIST_UPDATE_TASK
```
- 修改任务属性（内容、截止日期、优先级、标签） [可选]
```
TODOIST_CLOSE_TASK
```
- 将任务标记为已完成 [可选]
```
TODOIST_REOPEN_TASK
```
- 恢复已完成的任务 [可选]
```
TODOIST_DELETE_TASK
```
- 永久删除任务 [可选]

CREATE_TASK的关键参数:

```
content
```
: 任务标题（支持Markdown和超链接）
```
description
```
: 附加说明（请勿在此处填写截止日期）
```
project_id
```
: 字母数字格式的项目ID；留空则添加到收件箱
```
section_id
```
: 字母数字格式的分区ID，用于指定任务在项目内的位置
```
parent_id
```
: 父任务ID，用于创建子任务
```
priority
```
: 1（普通）到4（紧急）——注意：Todoist界面中p1代表紧急，但API中p4代表紧急

due_string

: 自然语言格式的日期，例如

"tomorrow at 3pm"

、

"every Friday at 9am"

```
due_date
```
: 特定日期，格式为
```
YYYY-MM-DD
```
```
due_datetime
```
: 特定日期+时间，格式为RFC3339标准的
```
YYYY-MM-DDTHH:mm:ssZ
```
```
labels
```
: 标签名称字符串数组
```
duration
```
+
```
duration_unit
```
: 任务时长（例如：
```
30
```
+
```
"minute"
```
）

注意事项:

同一时间只能使用一个
```
due_*
```
字段（
```
due_lang
```
可与任意
```
due_*
```
字段搭配使用除外）
请勿在
```
content
```
或
```
description
```
中嵌入截止日期——请使用
```
due_string
```
字段
请勿在
```
due_string
```
中嵌入时长描述，如"for 30 minutes"——请使用
```
duration
```
+
```
duration_unit
```
API中的
```
priority
```
：1=普通，4=紧急（与Todoist界面显示相反，界面中p1=紧急）
任务ID可以是数字或字母数字格式；请使用API返回的格式
```
CLOSE_TASK
```
是标记完成；
```
DELETE_TASK
```
是永久删除——这是两个不同的操作

2. Manage Projects

2. 管理项目

When to use: User wants to list, create, update, or inspect projects

Tool sequence:

```
TODOIST_GET_ALL_PROJECTS
```
- List all projects with metadata [Required]
```
TODOIST_GET_PROJECT
```
- Get details for a specific project by ID [Optional]
```
TODOIST_CREATE_PROJECT
```
- Create a new project with name, color, view style [Optional]
```
TODOIST_UPDATE_PROJECT
```
- Modify project properties [Optional]

Key parameters:

```
name
```
: Project name (required for creation)
```
color
```
: Todoist palette color (e.g.,
```
"blue"
```
,
```
"red"
```
,
```
"green"
```
,
```
"charcoal"
```
)
```
view_style
```
:
```
"list"
```
or
```
"board"
```
layout
```
parent_id
```
: Parent project ID for creating sub-projects
```
is_favorite
```
/
```
favorite
```
: Boolean to mark as favorite
```
project_id
```
: Required for update and get operations

Pitfalls:

Projects with similar names can lead to selecting the wrong project_id; always verify

CREATE_PROJECT

uses

favorite

while

UPDATE_PROJECT

uses

is_favorite

-- different field names

Use the project
```
id
```
returned by API, not the
```
v2_id
```
, for downstream operations
Alphanumeric/URL-style project IDs may cause HTTP 400 in some tools; use numeric ID if available

适用场景：用户需要列出、创建、更新或查看项目详情

工具执行序列:

```
TODOIST_GET_ALL_PROJECTS
```
- 列出所有项目及其元数据 [必填]
```
TODOIST_GET_PROJECT
```
- 通过ID获取特定项目的详情 [可选]
```
TODOIST_CREATE_PROJECT
```
- 创建新项目，可设置名称、颜色、视图样式 [可选]
```
TODOIST_UPDATE_PROJECT
```
- 修改项目属性 [可选]

关键参数:

```
name
```
: 项目名称（创建时必填）
```
color
```
: Todoist调色板中的颜色（例如：
```
"blue"
```
、
```
"red"
```
、
```
"green"
```
、
```
"charcoal"
```
）
```
view_style
```
: 布局样式，可选
```
"list"
```
（列表）或
```
"board"
```
（看板）
```
parent_id
```
: 父项目ID，用于创建子项目
```
is_favorite
```
/
```
favorite
```
: 布尔值，标记为收藏项目
```
project_id
```
: 更新和查询操作时必填

注意事项:

名称相似的项目可能导致选择错误的project_id；请务必验证
```
CREATE_PROJECT
```
使用
```
favorite
```
字段，而
```
UPDATE_PROJECT
```
使用
```
is_favorite
```
字段——字段名称不同
后续操作请使用API返回的项目
```
id
```
，而非
```
v2_id
```
部分工具可能不支持字母数字/URL格式的项目ID，若出现HTTP 400错误，请尝试使用数字ID

3. Manage Sections

3. 管理分区

When to use: User wants to organize tasks within projects using sections

Tool sequence:

```
TODOIST_GET_ALL_PROJECTS
```
- Find the target project ID [Prerequisite]
```
TODOIST_GET_ALL_SECTIONS
```
- List existing sections to avoid duplicates [Prerequisite]
```
TODOIST_CREATE_SECTION
```
- Create a new section in a project [Required]
```
TODOIST_UPDATE_SECTION
```
- Rename an existing section [Optional]
```
TODOIST_DELETE_SECTION
```
- Permanently remove a section [Optional]

Key parameters:

```
project_id
```
: Required -- the project to create the section in
```
name
```
: Section name (required for creation)
```
order
```
: Integer position within the project (lower values appear first)
```
section_id
```
: Required for update and delete operations

Pitfalls:

```
CREATE_SECTION
```
requires
```
project_id
```
and
```
name
```
-- omitting project_id causes a 400 error
HTTP 400 "project_id is invalid" can occur if alphanumeric ID is used; prefer numeric ID
Deleting a section may move or regroup its tasks in non-obvious ways
Response may include both
```
id
```
and
```
v2_id
```
; store and reuse the correct identifier consistently
Always check existing sections first to avoid creating duplicates

适用场景：用户需要使用分区来组织项目内的任务

工具执行序列:

```
TODOIST_GET_ALL_PROJECTS
```
- 找到目标项目ID [前提步骤]
```
TODOIST_GET_ALL_SECTIONS
```
- 列出已存在的分区，避免重复创建 [前提步骤]
```
TODOIST_CREATE_SECTION
```
- 在项目中创建新分区 [必填]
```
TODOIST_UPDATE_SECTION
```
- 重命名现有分区 [可选]
```
TODOIST_DELETE_SECTION
```
- 永久删除分区 [可选]

关键参数:

```
project_id
```
: 必填——分区所属的项目ID
```
name
```
: 分区名称（创建时必填）
```
order
```
: 整数，代表分区在项目中的位置（值越小越靠前）
```
section_id
```
: 更新和删除操作时必填

注意事项:

```
CREATE_SECTION
```
需要
```
project_id
```
和
```
name
```
——省略project_id会导致400错误
若使用字母数字ID，可能会出现HTTP 400 "project_id is invalid"错误；建议使用数字ID
删除分区可能会导致其下的任务以非预期的方式移动或重组
响应结果可能同时包含
```
id
```
和
```
v2_id
```
；请始终一致地存储和使用正确的标识符
请先检查现有分区，避免重复创建

4. Search and Filter Tasks

4. 搜索与筛选任务

When to use: User wants to find tasks by criteria, view today's tasks, or get completed task history

Tool sequence:

```
TODOIST_GET_ALL_TASKS
```
- Fetch incomplete tasks with optional filter query [Required]
```
TODOIST_GET_TASK
```
- Get full details of a specific task by ID [Optional]
```
TODOIST_GET_COMPLETED_TASKS_BY_COMPLETION_DATE
```
- Retrieve completed tasks within a date range [Optional]
```
TODOIST_LIST_FILTERS
```
- List user's custom saved filters [Optional]

Key parameters for GET_ALL_TASKS:

```
filter
```
: Todoist filter syntax string
- Keywords:
```
today
```
  ,
```
tomorrow
```
  ,
```
overdue
```
  ,
```
no date
```
  ,
```
recurring
```
  ,
```
subtask
```
- Priority:
```
p1
```
  (urgent),
```
p2
```
  ,
```
p3
```
  ,
```
p4
```
  (normal)
- Projects:
```
#ProjectName
```
  (must exist in account)
- Labels:
```
@LabelName
```
  (must exist in account)
- Date ranges:
```
7 days
```
  ,
```
-7 days
```
  ,
```
due before: YYYY-MM-DD
```
  ,
```
due after: YYYY-MM-DD
```
- Search:
```
search: keyword
```
  for content text search
- Operators:
```
&
```
  (AND),
```
|
```
  (OR),
```
!
```
  (NOT)
```
ids
```
: List of specific task IDs to retrieve

Key parameters for GET_COMPLETED_TASKS_BY_COMPLETION_DATE:

```
since
```
: Start date in RFC3339 format (e.g.,
```
2024-01-01T00:00:00Z
```
)
```
until
```
: End date in RFC3339 format
```
project_id
```
,
```
section_id
```
,
```
parent_id
```
: Optional filters
```
cursor
```
: Pagination cursor from previous response
```
limit
```
: Max results per page (default 50)

Pitfalls:

```
GET_ALL_TASKS
```
returns ONLY incomplete tasks; use
```
GET_COMPLETED_TASKS_BY_COMPLETION_DATE
```
for completed ones
Filter terms must reference ACTUAL EXISTING entities; arbitrary text causes HTTP 400 errors
Do NOT use
```
completed
```
,
```
!completed
```
, or
```
completed after
```
in GET_ALL_TASKS filter -- causes 400 error
```
GET_COMPLETED_TASKS_BY_COMPLETION_DATE
```
limits date range to approximately 3 months between
```
since
```
and
```
until
```
Search uses
```
search: keyword
```
syntax within the filter, not a separate parameter

适用场景：用户需要根据条件查找任务、查看今日任务或获取已完成任务的历史记录

工具执行序列:

```
TODOIST_GET_ALL_TASKS
```
- 获取未完成任务，可附带筛选查询条件 [必填]
```
TODOIST_GET_TASK
```
- 通过ID获取特定任务的完整详情 [可选]
```
TODOIST_GET_COMPLETED_TASKS_BY_COMPLETION_DATE
```
- 获取指定日期范围内的已完成任务 [可选]
```
TODOIST_LIST_FILTERS
```
- 列出用户自定义的已保存筛选器 [可选]

GET_ALL_TASKS的关键参数:

```
filter
```
: Todoist筛选语法字符串
- 关键字：
```
today
```
  、
```
tomorrow
```
  、
```
overdue
```
  、
```
no date
```
  、
```
recurring
```
  、
```
subtask
```
- 优先级：
```
p1
```
  （紧急）、
```
p2
```
  、
```
p3
```
  、
```
p4
```
  （普通）
- 项目：
```
#ProjectName
```
  （必须是账户中已存在的项目）
- 标签：
```
@LabelName
```
  （必须是账户中已存在的标签）
- 日期范围：
```
7 days
```
  、
```
-7 days
```
  、
```
due before: YYYY-MM-DD
```
  、
```
due after: YYYY-MM-DD
```
- 搜索：
```
search: keyword
```
  用于内容文本搜索
- 运算符：
```
&
```
  （与）、
```
|
```
  （或）、
```
!
```
  （非）
```
ids
```
: 要获取的特定任务ID列表

GET_COMPLETED_TASKS_BY_COMPLETION_DATE的关键参数:

```
since
```
: 起始日期，格式为RFC3339（例如：
```
2024-01-01T00:00:00Z
```
）
```
until
```
: 结束日期，格式为RFC3339
```
project_id
```
,
```
section_id
```
,
```
parent_id
```
: 可选筛选条件
```
cursor
```
: 来自上一次响应的分页游标
```
limit
```
: 每页最大结果数（默认50）

注意事项:

```
GET_ALL_TASKS
```
仅返回未完成的任务；已完成任务请使用
```
GET_COMPLETED_TASKS_BY_COMPLETION_DATE
```
筛选条件必须引用账户中实际存在的实体；任意文本会导致HTTP 400错误
请勿在GET_ALL_TASKS的筛选条件中使用
```
completed
```
、
```
!completed
```
或
```
completed after
```
——会导致400错误

GET_COMPLETED_TASKS_BY_COMPLETION_DATE

的日期范围限制为

since

和

until

之间约3个月

文本搜索需在筛选条件中使用
```
search: keyword
```
语法，而非单独的参数

5. Bulk Task Creation

5. 批量创建任务

When to use: User wants to scaffold a project with multiple tasks at once

Tool sequence:

```
TODOIST_GET_ALL_PROJECTS
```
- Find target project ID [Prerequisite]
```
TODOIST_GET_ALL_SECTIONS
```
- Find section IDs for task placement [Optional]
```
TODOIST_BULK_CREATE_TASKS
```
- Create multiple tasks in a single request [Required]

Key parameters:

```
tasks
```
: Array of task objects, each requiring at minimum
```
content
```

Each task object supports:

content

description

project_id

section_id

parent_id

priority

labels

due

(object with

string

date

, or

datetime

duration

order

Pitfalls:

Each task in the array must have at least the
```
content
```
field
The
```
due
```
field in bulk create is an object with nested fields (
```
string
```
,
```
date
```
,
```
datetime
```
,
```
lang
```
) -- different structure from CREATE_TASK's flat fields
All tasks can target different projects/sections within the same batch

适用场景：用户需要一次性为项目创建多个任务

工具执行序列:

```
TODOIST_GET_ALL_PROJECTS
```
- 找到目标项目ID [前提步骤]
```
TODOIST_GET_ALL_SECTIONS
```
- 找到任务所属的分区ID [可选]
```
TODOIST_BULK_CREATE_TASKS
```
- 一次请求创建多个任务 [必填]

关键参数:

```
tasks
```
: 任务对象数组，每个对象至少需要
```
content
```
字段

每个任务对象支持的字段：

content

、

description

、

project_id

、

section_id

、

parent_id

、

priority

、

labels

、

due

（包含

string

、

date

或

datetime

的对象）、

duration

、

order

注意事项:

数组中的每个任务必须至少包含
```
content
```
字段
批量创建中的
```
due
```
字段是一个包含嵌套字段（
```
string
```
、
```
date
```
、
```
datetime
```
、
```
lang
```
）的对象——与CREATE_TASK中的扁平字段结构不同
同一批次中的任务可以属于不同的项目/分区

Common Patterns

通用模式

ID Resolution

ID解析

Always resolve human-readable names to IDs before operations:

Project name -> Project ID:
```
TODOIST_GET_ALL_PROJECTS
```
, match by
```
name
```
field
Section name -> Section ID:
```
TODOIST_GET_ALL_SECTIONS
```
with
```
project_id
```

Task content -> Task ID:

TODOIST_GET_ALL_TASKS

with

filter

search: keyword

在执行操作前，请始终将人类可读的名称解析为ID：

项目名称 -> 项目ID：使用
```
TODOIST_GET_ALL_PROJECTS
```
，通过
```
name
```
字段匹配
分区名称 -> 分区ID：使用带
```
project_id
```
参数的
```
TODOIST_GET_ALL_SECTIONS
```
任务内容 -> 任务ID：使用带
```
filter
```
或
```
search: keyword
```
参数的
```
TODOIST_GET_ALL_TASKS
```

Pagination

分页

```
TODOIST_GET_ALL_TASKS
```
: Returns all matching incomplete tasks (no pagination needed)
```
TODOIST_GET_COMPLETED_TASKS_BY_COMPLETION_DATE
```
: Uses cursor-based pagination; follow
```
cursor
```
from response until no more results

TODOIST_GET_ALL_PROJECTS

and

TODOIST_GET_ALL_SECTIONS

: Return all results (no pagination)

```
TODOIST_GET_ALL_TASKS
```
: 返回所有匹配的未完成任务（无需分页）
```
TODOIST_GET_COMPLETED_TASKS_BY_COMPLETION_DATE
```
: 使用基于游标的分页；请跟随响应中的
```
cursor
```
直到没有更多结果

TODOIST_GET_ALL_PROJECTS

和

TODOIST_GET_ALL_SECTIONS

: 返回所有结果（无需分页）

Due Date Handling

截止日期处理

Natural language: Use

due_string

(e.g.,

"tomorrow at 3pm"

"every Monday"

)

Specific date: Use
```
due_date
```
in
```
YYYY-MM-DD
```
format
Specific datetime: Use
```
due_datetime
```
in RFC3339 format (
```
YYYY-MM-DDTHH:mm:ssZ
```
)
Only use ONE due field at a time (except
```
due_lang
```
which can accompany any)
Recurring tasks: Use natural language in
```
due_string
```
(e.g.,
```
"every Friday at 9am"
```
)

自然语言：使用

due_string

（例如：

"tomorrow at 3pm"

、

"every Monday"

）

特定日期：使用
```
due_date
```
，格式为
```
YYYY-MM-DD
```
特定日期时间：使用
```
due_datetime
```
，格式为RFC3339标准的
```
YYYY-MM-DDTHH:mm:ssZ
```
同一时间只能使用一个截止日期字段（
```
due_lang
```
可与任意截止日期字段搭配使用除外）
重复任务：在
```
due_string
```
中使用自然语言（例如：
```
"every Friday at 9am"
```
）

Known Pitfalls

已知注意事项

ID Formats

ID格式

Task IDs can be numeric (
```
"2995104339"
```
) or alphanumeric (
```
"6X4Vw2Hfmg73Q2XR"
```
)
Project IDs similarly vary; prefer the format returned by the API
Some tools accept only numeric IDs; if 400 error occurs, try fetching the numeric
```
id
```
via GET_PROJECT
Response objects may contain both
```
id
```
and
```
v2_id
```
; use
```
id
```
for API operations

任务ID可以是数字格式（
```
"2995104339"
```
）或字母数字格式（
```
"6X4Vw2Hfmg73Q2XR"
```
）
项目ID格式也类似；请优先使用API返回的格式
部分工具仅支持数字ID；若出现400错误，请尝试通过GET_PROJECT获取数字
```
id
```
响应对象可能同时包含
```
id
```
和
```
v2_id
```
；请使用
```
id
```
进行API操作

Priority Inversion

优先级反转

API priority: 1 = normal, 4 = urgent
Todoist UI display: p1 = urgent, p4 = normal
This is inverted; always clarify with the user which convention they mean

API中的优先级：1 = 普通，4 = 紧急
Todoist界面中的显示：p1 = 紧急，p4 = 普通
两者是相反的；请务必向用户确认他们所指的是哪种约定

Filter Syntax

筛选语法

Filter terms must reference real entities in the user's account
```
#NonExistentProject
```
or
```
@NonExistentLabel
```
will cause HTTP 400
Use
```
search: keyword
```
for text search, not bare keywords
Combine with
```
&
```
(AND),
```
|
```
(OR),
```
!
```
(NOT)
```
completed
```
filters do NOT work on GET_ALL_TASKS endpoint

筛选条件必须引用用户账户中实际存在的实体
使用
```
#NonExistentProject
```
或
```
@NonExistentLabel
```
会导致HTTP 400错误
文本搜索请使用
```
search: keyword
```
语法，而非直接使用关键词
可使用
```
&
```
（与）、
```
|
```
（或）、
```
!
```
（非）组合条件
```
completed
```
筛选条件在GET_ALL_TASKS端点中无效

Rate Limits

速率限制

Todoist API has rate limits; batch operations should use
```
BULK_CREATE_TASKS
```
where possible
Space out rapid sequential requests to avoid throttling

Todoist API有速率限制；批量操作请尽可能使用
```
BULK_CREATE_TASKS
```
请间隔快速连续的请求，避免被限流

Quick Reference

快速参考

Task	Tool Slug	Key Params
List all projects	`TODOIST_GET_ALL_PROJECTS`	(none)
Get project	`TODOIST_GET_PROJECT`	`project_id`
Create project	`TODOIST_CREATE_PROJECT`	`name` , `color` , `view_style`
Update project	`TODOIST_UPDATE_PROJECT`	`project_id` , `name` , `color`
List sections	`TODOIST_GET_ALL_SECTIONS`	`project_id`
Create section	`TODOIST_CREATE_SECTION`	`project_id` , `name` , `order`
Update section	`TODOIST_UPDATE_SECTION`	`section_id` , `name`
Delete section	`TODOIST_DELETE_SECTION`	`section_id`
Get all tasks	`TODOIST_GET_ALL_TASKS`	`filter` , `ids`
Get task	`TODOIST_GET_TASK`	`task_id`
Create task	`TODOIST_CREATE_TASK`	`content` , `project_id` , `due_string` , `priority`
Bulk create tasks	`TODOIST_BULK_CREATE_TASKS`	`tasks` (array)
Update task	`TODOIST_UPDATE_TASK`	`task_id` , `content` , `due_string`
Complete task	`TODOIST_CLOSE_TASK`	`task_id`
Reopen task	`TODOIST_REOPEN_TASK`	`task_id`
Delete task	`TODOIST_DELETE_TASK`	`task_id`
Completed tasks	`TODOIST_GET_COMPLETED_TASKS_BY_COMPLETION_DATE`	`since` , `until`
List filters	`TODOIST_LIST_FILTERS`	`sync_token`

操作	工具标识	关键参数
列出所有项目	`TODOIST_GET_ALL_PROJECTS`	无
获取项目详情	`TODOIST_GET_PROJECT`	`project_id`
创建项目	`TODOIST_CREATE_PROJECT`	`name` , `color` , `view_style`
更新项目	`TODOIST_UPDATE_PROJECT`	`project_id` , `name` , `color`
列出分区	`TODOIST_GET_ALL_SECTIONS`	`project_id`
创建分区	`TODOIST_CREATE_SECTION`	`project_id` , `name` , `order`
更新分区	`TODOIST_UPDATE_SECTION`	`section_id` , `name`
删除分区	`TODOIST_DELETE_SECTION`	`section_id`
获取所有任务	`TODOIST_GET_ALL_TASKS`	`filter` , `ids`
获取任务详情	`TODOIST_GET_TASK`	`task_id`
创建任务	`TODOIST_CREATE_TASK`	`content` , `project_id` , `due_string` , `priority`
批量创建任务	`TODOIST_BULK_CREATE_TASKS`	`tasks` （数组）
更新任务	`TODOIST_UPDATE_TASK`	`task_id` , `content` , `due_string`
标记任务完成	`TODOIST_CLOSE_TASK`	`task_id`
重新打开任务	`TODOIST_REOPEN_TASK`	`task_id`
删除任务	`TODOIST_DELETE_TASK`	`task_id`
获取已完成任务	`TODOIST_GET_COMPLETED_TASKS_BY_COMPLETION_DATE`	`since` , `until`
列出筛选器	`TODOIST_LIST_FILTERS`	`sync_token`