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 }.