My Todos
list_my_todosRead-onlyIdempotent
List your GitLab to-do items, such as pending merge requests, issues, and review requests. Filter by state, target type, or project to focus on specific tasks.
Instructions
List the authenticated user's GitLab to-do items (notifications about issues, MRs, mentions, reviews requested, etc.). Filter by state, action, target type, or group/project. Requires user authentication.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sort | No | Sort order — e.g. CREATED_DESC (default on server), CREATED_ASC, UPDATED_DESC, UPDATED_ASC. | |
| type | No | Filter by target type — e.g. Issue, MergeRequest, Epic, Commit, DesignManagement::Design, AlertManagement::Alert | |
| after | No | Pagination cursor. To fetch the next page, pass the previous response pageInfo.endCursor here and repeat until pageInfo.hasNextPage is false. Paginating this way is the reliable path to complete results and accurate totals. | |
| first | No | Number of todos to retrieve | |
| state | No | Filter by todo state: pending (default), done, or all | pending |
| action | No | Filter by todo action — e.g. assigned, mentioned, build_failed, marked, approval_required, unmergeable, directly_addressed, review_requested | |
| fetchAll | No | Fetch multiple pages in one call, up to "first" items total (max 100) — NOT exhaustive. For complete results or accurate counts, leave this false and paginate via after (pageInfo.endCursor). | |
| authorIds | No | Filter by todo authors. Accepts numeric user IDs or full gid://gitlab/User/N strings. | |
| groupPath | No | Limit to a group by full path (e.g. "my-org/platform"). Resolved to a node GID server-side before filtering. | |
| isSnoozed | No | Filter by snooze state: true → only snoozed, false → only non-snoozed. | |
| projectPath | No | Limit to a project by full path (e.g. "my-org/my-repo"). Resolved to a node GID server-side before filtering. | |
| userCredentials | No | Your GitLab credentials (optional — falls back to the configured env token if not provided) |