MCP Tools: Lists
list_lists
Lists the user has access to. read · follower
| Parameter | Type | Default | Description |
|---|---|---|---|
status | string | – | open, inprogress, done, completed, closed, archived |
lifecycle | string | – | active, archived, trashed |
search | string | – | Search in name and description |
includeTemplates | boolean | false | Include templates |
excludeCompleted | boolean | false | Hide completed/closed lists |
limit | number | 50 | Number of results |
offset | number | 0 | Results to skip |
Response: { lists, total, limit, offset, has_more }.
get_list
List including its items. read · follower
| Parameter | Type | Default | Description |
|---|---|---|---|
listId | string (required) | – | UUID or SID |
includeItems | boolean | true | Include items |
includeArchived | boolean | false | Include archived items |
compact | boolean | false | Only id, sid, parent, text, status, priority, target_date |
create_list
Create a new list. write · user
| Parameter | Type | Description |
|---|---|---|
name | string (required) | Name (min. 1 character) |
description | string | Description |
type | string | Type |
status | string | Initial status |
color | string | Color |
tags | string[] | Tags |
update_list
Update a list. write · user
| Parameter | Type | Description |
|---|---|---|
listId | string (required) | UUID or SID |
name | string | New name |
description | string | New description |
status | string | New status |
lifecycle | string | New lifecycle state |
color | string | New color |
locked | boolean | Lock/unlock |
tags | string[] | New tags |
delete_list
Move a list to the trash. destructive · admin
| Parameter | Type | Description |
|---|---|---|
listId | string (required) | UUID or SID |
get_list_stats
Statistics for a list. read · follower
| Parameter | Type | Description |
|---|---|---|
listId | string (required) | UUID or SID |
Response: { total, todo, in_progress, done, overdue, archived, completion_rate }.