MCP Tools: List Items
Tasks ("items") live inside lists. Assignments are stored in refs ({type:'user',id}) and are returned as assignees.
list_list_items
Filter items. read · follower
| Parameter | Type | Default | Description |
|---|---|---|---|
listId | string | – | Filter by list |
state | enum open | done | all | all | open = not completed (status not done/completed) |
status | string | – | Exact status (e.g. todo). For "not finished", prefer state |
priority | number (1–9) | – | Filter by priority |
assigned_to | string | – | Filter by assigned user (refs, type=user) |
assigned_to_me | boolean | – | Only items assigned to me (no get_me needed) |
tag | string | – | Exact tag (e.g. ki/claude) |
search | string | – | Search in text and description |
due_within_days | number | – | Due within N days (including overdue) |
due_before | string (ISO) | – | Due before a date |
includeArchived | boolean | false | Include archived items |
sort | enum default | priority | due_date | created | modified | default | Sort order |
compact | boolean | false | Core fields + assignees only |
limit | number | 50 | Count |
offset | number | 0 | Skip |
Response: { items, total, limit, offset, has_more }.
get_list_item
A single item. read · follower
| Parameter | Type | Description |
|---|---|---|
itemId | string (required) | UUID or SID |
create_list_item
Create a new item. write · user
| Parameter | Type | Description |
|---|---|---|
listId | string (required) | UUID or SID of the list |
text | string (required) | Title (min. 1 character) |
description | string | Description |
status | string | Status |
priority | number (1–9) | Priority (9 = urgent) |
assigned_to | string[] | Assigned user IDs |
tags | string[] | Tags |
target_date | string (ISO) | Due date |
parent | string | Parent item |
update_list_item
Update an item. write · user
| Parameter | Type | Description |
|---|---|---|
itemId | string (required) | UUID or SID |
text, description, status | string | new values |
priority | number (1–9) | new priority |
assigned_to | string[] | new assignments |
tags | string[] | new tags |
target_date | string | null | new date |
progress | number (0–100) | Progress |
archived | boolean | archive |
expectedVersion | integer | Optimistic Lock |
complete_list_item
Mark as completed (status done, progress 100). write · user
| Parameter | Type | Default | Description |
|---|---|---|---|
itemId | string (required) | – | UUID or SID |
reopen | boolean | false | Reopen (status open, progress 0) |
expectedVersion | integer | – | Optimistic Lock |
complete_list_items
Complete/reopen multiple items (bulk). write · user
| Parameter | Type | Default | Description |
|---|---|---|---|
itemIds | string[] (required) | – | UUIDs/SIDs (min. 1) |
reopen | boolean | false | Reopen instead of completing |
Response: { succeeded, failed, results[] } (per-item result).
update_list_items
Apply the same field updates to multiple items (bulk). write · user
| Parameter | Type | Description |
|---|---|---|
itemIds | string[] (required) | UUIDs/SIDs (min. 1) |
status | string | for all |
priority | number (1–9) | for all |
assigned_to | string[] | for all |
tags | string[] | for all |
target_date | string | null | for all |
progress | number (0–100) | for all |
archived | boolean | for all |
delete_list_item
Move to the trash. destructive · admin
| Parameter | Type | Description |
|---|---|---|
itemId | string (required) | UUID or SID |
expectedVersion | integer | Optimistic Lock |
get_overdue_list_items
Overdue items. read · follower
| Parameter | Type | Default | Description |
|---|---|---|---|
listId | string | – | By list |
compact | boolean | false | Core fields + days_overdue |
limit | number | 50 | Count |
get_my_open_items
My open tasks (overdue → due → priority). read · follower
| Parameter | Type | Default | Description |
|---|---|---|---|
listId | string | – | Restrict to a single list |
includeUndated | boolean | true | Include items without a date |
compact | boolean | false | Core fields |
limit | number | 50 | Count |
list_recent_changes
Recently changed items (sync/polling). read · follower
| Parameter | Type | Default | Description |
|---|---|---|---|
since | string (ISO) | – | Only items changed since this point in time |
listId | string | – | Restrict to a single list |
compact | boolean | false | Core fields + modified |
limit | number | 50 | Count |
search_list_items
Full-text search across items. read · follower
| Parameter | Type | Default | Description |
|---|---|---|---|
query | string (required) | – | Search term (min. 1 character) |
compact | boolean | false | Core fields |
limit | number | 20 | Count |
post_chat_message
Post a message to an item's chat (or a list's chat). write · user
| Parameter | Type | Description |
|---|---|---|
itemId | string | Target item (UUID/SID) |
listId | string | Target list (alternative to itemId) |
text | string (required) | Message text |
get_chat_messages
Read the chat history (oldest first). read · follower
| Parameter | Type | Default | Description |
|---|---|---|---|
itemId | string | – | Item chat |
listId | string | – | List chat (alternative) |
limit | number | 50 | Max. messages |
offset | number | 0 | Skip |
get_metadata
Reference: valid status/priority/scope/filter values. read · guest
No parameters. Call before creating/updating to use correct values.