list_my_work
The work items assigned to the person the token acts as, across every project the token may see, open ones by default.
Return the work items assigned to the person you act as, across every project the token may see, newest change first: each with its reference, project, kind, title, status, priority, estimates and dates. Read it at the start of a session to know what is on the person's plate, or when they ask what is next; the open items (neither done nor cancelled) come back by default and include_closed adds the done and cancelled ones.
The list spans projects, so read project_id and reference together when you report, and read the item with get_work_item before you implement it. A guest token reads the agreed items only, which is none until an approval pins them.
Requires ability
The token behind the MCP session must hold it, or the call is refused with TOKEN_MISSING_ABILITY.
Runs the same action as
The REST endpoint and this tool share one action, so validation, permissions and events are identical.
Annotations
It reads and never changes anything.
Arguments
include_closedbooleanoptionalTrue to include the done and cancelled items too.
limitintegeroptionalItems per page (1..100, default 25).
1max100pageintegeroptional1-indexed page number.
1What it returns
{ "data": [ { "id": "b2c3d4e5-f6a7-4b8c-9d0e-1f2a3b4c5d6e", "project_id": "7f3d1c92-8b45-4e6a-9d21-5c8e0a4b6f13", "number": 142, "reference": "CRM-142", "type": "story", "parent_id": null, "epic_id": "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d", "title": "Tier upgrade email", "description": null, "status": "ready", "resolution": null, "priority": "high", "assignee_id": "c3d4e5f6-a7b8-4c9d-8e0f-1a2b3c4d5e6f", "assignee_name": "Nimal Fernando", "reporter_id": "d4e5f6a7-b8c9-4d0e-9f1a-2b3c4d5e6f70", "reporter_name": "Dilani Perera", "reviewer_id": null, "qa_owner_id": null, "story_points": "5", "estimate_minutes": null, "remaining_minutes": null, "due_on": "2026-11-20", "started_at": null, "completed_at": null, "persona_id": null, "as_a": "gold member", "i_want": "to be told the day I reach platinum", "so_that": "I use the new perks straight away", "business_value_points": null, "severity": null, "environment_id": null, "component_id": null, "steps_to_reproduce": null, "expected_result": null, "actual_result": null, "reproducible": null, "timebox_minutes": null, "outcome": null, "component_ids": [], "acceptance_criteria": [], "position": 3, "version": 0, "approved_at": null, "created_at": "2026-10-28T09:20:00+00:00", "updated_at": "2026-11-01T16:30:00+00:00" } ], "meta": { "page": 1, "limit": 25, "total": 1, "has_more": false }}How it fails
TOKEN_MISSING_ABILITYtoken lacks work-item:view-any.
How is this guide?
Last updated on