GitHub Notifications MCP Server

Name: GitHub Notifications MCP Server
Author: mcollina

@mcollina

代码仓库

关于 GitHub Notifications MCP Server

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

基本信息

分类

版本控制

许可证

MIT

运行时

node

传输方式

stdio

发布者

mcollina

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "github-notifications": {
      "command": "node",
      "args": [
        "/absolute/path/to/github-notifications-mcp-server/build/index.js"
      ],
      "env": {
        "GITHUB_TOKEN": "your_github_personal_access_token_here"
      }
    }
  }
}

工具

List all GitHub notifications for the authenticated user

Mark all notifications as read

Get information about a notification thread

Mark a specific thread as read

Mark a thread as done

Get subscription status for a thread

Subscribe to a thread

Unsubscribe from a thread

List notifications for a specific repository

Mark notifications for a repository as read

Manage repository subscriptions: all_activity, default (participating and @mentions), or ignore (mute)

概览

What is GitHub Notifications MCP Server?

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

How to use GitHub Notifications MCP Server?

Prerequisites: Node.js 18+, GitHub Personal Access Token (classic) with notifications or repo scope. Clone the repo, run npm install and npm run build, then either start directly with npm start or configure it in Claude Desktop’s claude_desktop_config.json using the node command pointing to the built index.js and passing the GITHUB_TOKEN environment variable.

Key features of GitHub Notifications MCP Server

List and filter GitHub notifications
Mark notifications as read
View notification thread details
Subscribe or unsubscribe from notification threads
Mark threads as done
Manage repository-specific notifications
Control repository notification settings (all activity, default, mute)

Use cases of GitHub Notifications MCP Server

Check and review unread GitHub notifications through a conversational AI
Mark all notifications or specific threads as read
Unsubscribe from unwanted notification threads
Manage repository notifications, e.g., watch all activity, set to default, or mute
Get thread details and subscription status

FAQ from GitHub Notifications MCP Server

What does GitHub Notifications MCP Server do?

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

What are the prerequisites?

Node.js 18 or higher and a GitHub Personal Access Token (classic) with the notifications or repo scope.

Where are notifications stored?

Notifications are fetched directly from the GitHub API using the provided token; no local storage is described.

How do I authenticate?

Set the token as the GITHUB_TOKEN environment variable, either in a .env file or directly in the MCP server configuration when used with Claude Desktop.