get_my_dashboard
Reads the dashboard of the person the token acts as in one call, with their open items by status, the items that ask for them today in order, the approvals waiting, the timer and this week's time, the weeks to put forward, the running sprints, their projects and the latest changes.
Start a session with it: one call tells you what the person's day holds. counts and open_count are their open items by status; focus lists the items that ask for them today, most pressing first, each with the item, a reason (Overdue by 2 days, Due today, Waiting for your review, Waiting for your test, In progress, Due tomorrow, Ready to start, On your plate), a score and a tone; approvals_waiting and approvals are the requests waiting on them; timer is their running timer with its item, or null; time_this_week their time with duration in words; weeks_to_submit the past weeks with time on a project and no timesheet put forward; sprints the running sprints with their progress and my_open_count; projects the live projects with health and my_open_count, the ones in trouble first; activity the latest changes across those projects when the person may read the team's log. Give project_id to narrow every section but the activity to one project. Then get_work_item for the item at the top of the focus list. A client guest's token reads the approvals and the projects alone, with internal false.
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
project_idstringoptionalUUID of a project, to narrow every section but the activity to it; leave it out for every project the token sees.
What it returns
{ "data": { "counts": { "in_progress": 1, "ready": 1, "backlog": 1 }, "open_count": 3, "focus": [ { "reason": "Overdue by 2 days", "tone": "red", "score": 102, "item": { "id": "b2c3d4e5-f6a7-4b8c-9d0e-1f2a3b4c5d6e", "project_id": "7f3d1c92-8b45-4e6a-9d21-5c8e0a4b6f13", "reference": "CRM-142", "type": "story", "title": "Reset a forgotten password", "status": "in_progress", "priority": "high", "due_on": "2026-10-31" } } ], "approvals_waiting": 0, "approvals": [], "timer": null, "time_this_week": { "minutes": 90, "billable_minutes": 90, "count": 1, "duration": "1h 30m" }, "weeks_to_submit": [ { "project_id": "7f3d1c92-8b45-4e6a-9d21-5c8e0a4b6f13", "project_key": "CRM", "project_name": "Customer Portal", "week_start": "2026-10-26", "minutes": 120, "duration": "2h", "count": 1, "status": "open" } ], "sprints": [ { "id": "1c2d3e4f-5a6b-4c7d-8e9f-0a1b2c3d4e5f", "name": "Sprint 1", "project_id": "7f3d1c92-8b45-4e6a-9d21-5c8e0a4b6f13", "project_key": "CRM", "project_name": "Customer Portal", "starts_on": "2026-10-30", "ends_on": "2026-11-12", "days_left": 10, "duration_days": 14, "points_planned": 10, "points_done": 2, "item_count": 3, "done_count": 1, "my_open_count": 2 } ], "projects": [ { "id": "7f3d1c92-8b45-4e6a-9d21-5c8e0a4b6f13", "key": "CRM", "name": "Customer Portal", "status": "in_development", "health": "unknown", "my_open_count": 2 } ], "activity": [], "internal": true }}How it fails
RESOURCE_NOT_FOUNDunknown project_id, or a project outside the token's scope.
TOKEN_MISSING_ABILITYtoken lacks dashboard:read.
How is this guide?
Last updated on