MCP Tools: Lists

Last updated 24 days ago

MCP Tools: Lists ​

list_lists ​

Lists the user has access to. read · follower

ParameterTypeDefaultDescription
statusstring–open, inprogress, done, completed, closed, archived
lifecyclestring–active, archived, trashed
searchstring–Search in name and description
includeTemplatesbooleanfalseInclude templates
excludeCompletedbooleanfalseHide completed/closed lists
limitnumber50Number of results
offsetnumber0Results to skip

Response: { lists, total, limit, offset, has_more }.

get_list ​

List including its items. read · follower

ParameterTypeDefaultDescription
listIdstring (required)–UUID or SID
includeItemsbooleantrueInclude items
includeArchivedbooleanfalseInclude archived items
compactbooleanfalseOnly id, sid, parent, text, status, priority, target_date

create_list ​

Create a new list. write · user

ParameterTypeDescription
namestring (required)Name (min. 1 character)
descriptionstringDescription
typestringType
statusstringInitial status
colorstringColor
tagsstring[]Tags

update_list ​

Update a list. write · user

ParameterTypeDescription
listIdstring (required)UUID or SID
namestringNew name
descriptionstringNew description
statusstringNew status
lifecyclestringNew lifecycle state
colorstringNew color
lockedbooleanLock/unlock
tagsstring[]New tags

delete_list ​

Move a list to the trash. destructive · admin

ParameterTypeDescription
listIdstring (required)UUID or SID

get_list_stats ​

Statistics for a list. read · follower

ParameterTypeDescription
listIdstring (required)UUID or SID

Response: { total, todo, in_progress, done, overdue, archived, completion_rate }.