Advertise
MCP.so
Sign In

GitHub Notifications MCP Server

@mcollina

Repository

Basic information

Category

Version Control

License

MIT

Transports

stdio

Author

mcollina

About GitHub Notifications MCP Server

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

GitHub Notifications MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "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"
      }
    }
  }
}

GitHub Notifications MCP Server tools

11

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)

Overview

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

Frequently asked questions

1

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.

2

What are the prerequisites?

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

3

Where are notifications stored?

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

4

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.

5

What transport protocol does it use?

The server is configured for stdio transport, as shown in the Claude Desktop configuration where it is launched as a child process via `node`.

Comments

More Version Control MCP servers

GitHub Stars MCP Server

ccbikai

A Cloudflare-powered MCP (Model Context Protocol) Server that allows you to search and query your GitHub starred repositories using natural language.

111

Atlassian Bitbucket MCP Server

aashari

Node.js/TypeScript MCP server for Atlassian Bitbucket. Enables AI systems (LLMs) to interact with workspaces, repositories, and pull requests via tools (list, get, comment, search). Connects AI directly to version control workflows through the standard MCP interface.

157

Linear MCP Server

cline

a private MCP server for accessing Linear

133

AIO-MCP Server

athapong

🚀 All-in-one MCP server with AI search, RAG, and multi-service integrations (GitLab/Jira/Confluence/YouTube) for AI-enhanced development workflows. Folk from https://github.com/nguyenvanduocit/all-in-one-model-context-protocol

36

MCP Linear

tacticlaunch

MCP server that enables AI assistants to interact with Linear project management system through natural language, allowing users to retrieve, create, and update issues, projects, and teams.

141
Advertise