List notifications
The List Notifications tool seamlessly integrates with GitHub to provide authenticated users with a comprehensive overview of their notifications. It includes unread alerts, mentions, review requests, assignments, and updates on issues or pull requests, enabling users to efficiently track their pending work and collaboration tasks.
Features
- Displays all GitHub notifications for the authenticated user, including unread items and mentions.
- Filters notifications by read status, participation, repository owner, or repository name.
- Supports pagination with customizable page number and results per page for easy navigation.
- Shows updates on issues, pull requests, review requests, assignments, and general GitHub activity.
- Helps users quickly identify actionable items, reminders, and pending tasks directly from their GitHub notifications.
Benefits
- Streamlines workflow by consolidating all relevant GitHub notifications in one place.
- Enhances productivity by highlighting pending reviews and assignments needing immediate attention.
- Reduces the chance of missing critical updates or mentions in collaborative projects.
- Customizable filters allow users to focus on notifications most pertinent to their current tasks.
- Facilitates efficient task prioritization and management based on real-time GitHub activity.
Description
Lists all GitHub notifications for the authenticated user, including unread notifications, mentions, review requests, assignments, and updates on issues or pull requests. Use this tool whenever the user asks what to work on next, requests a summary of their GitHub activity, wants to see pending reviews, or needs to check for new updates or tasks. This tool is the primary way to discover actionable items, reminders, and outstanding work on GitHub. Always call this tool when asked what to work on next, what is pending, or what needs attention in GitHub.
Parameters
7 parameters
| Name | Type | Description |
|---|---|---|
| before | string | Only show notifications updated before the given time (ISO 8601 format) |
| filter | enum | Filter notifications to, use default unless specified. Read notifications are ones that have already been acknowledged by the user. Participating notifications are those that the user is directly involved in, such as issues or pull requests they have commented on or created. |
| owner | string | Optional repository owner. If provided with repo, only notifications for this repository are listed. |
| page | number | Page number for pagination (min 1) |
| perPage | number | Results per page for pagination (min 1, max 100) |
| repo | string | Optional repository name. If provided with owner, only notifications for this repository are listed. |
| since | string | Only show notifications updated after the given time (ISO 8601 format) |
