GitHub Notifications MCP Server

An MCP server for the github notifications API for the OSS maintainer

Local serverstdioTypeScript

What is the GitHub Notifications MCP Server?

An MCP server for the github notifications API for the OSS maintainer

What the server does

An MCP (Model Context Protocol) server that provides tools for managing GitHub notifications. This server allows AI assistants like Claude to help you manage your GitHub notifications through natural language commands.

  • List and filter your GitHub notifications
  • Mark notifications as read
  • View notification thread details
  • Subscribe or unsubscribe from notification threads
  • Mark threads as done
  • Manage repository-specific notifications

Credentials and setup notes

  • Node.js 18 or higher - GitHub Personal Access Token (classic) with notifications or repo scope

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
list-notificationsList all GitHub notifications for the authenticated user
mark-notifications-readMark all notifications as read
get-threadGet information about a notification thread
mark-thread-readMark a specific thread as read
mark-thread-doneMark a thread as done
get-thread-subscriptionGet subscription status for a thread
set-thread-subscriptionSubscribe to a thread
delete-thread-subscriptionUnsubscribe from a thread
list-repo-notificationsList notifications for a specific repository
mark-repo-notifications-readMark notifications for a repository as read
manage-repo-subscriptionManage repository subscriptions: all_activity, default (participating and @mentions), or ignore (mute)

Configuration

  • Node.js 18 or higher - GitHub Personal Access Token (classic) with notifications or repo scope
VariableDescriptionRequired
GITHUB_TOKENCredential the server authenticates with.Yes

Example prompts to try

  • “Use GitHub Notifications to list-notifications.”
  • “Use GitHub Notifications to mark-notifications-read.”
  • “Use GitHub Notifications to get-thread.”

Frequently asked questions

It provides tools for AI assistants to list, filter, read, mark, and manage GitHub notification subscriptions via natural language commands.