GitHub Webhooks MCP Server

A Model Context Protocol (MCP) server for managing GitHub webhooks at both organization and repository levels.

- create_org_webhook- Create webhooks that apply to all repositories in an organization
- list_org_webhooks- List all organization-level webhooks
- update_org_webhook- Modify existing organization webhooks
- delete_org_webhook- Remove organization webhooks

- create_repo_webhook- Create webhooks for a specific repository
- list_repo_webhooks- List all webhooks for a repository
- update_repo_webhook- Modify existing repository webhooks
- delete_repo_webhook- Remove repository webhooks

The server requires a GitHub personal access token with appropriate permissions:

- For organization webhooks:admin:org_hookscope
- For repository webhooks:admin:repo_hookscope

Set the token as an environment variable:

export GITHUB_TOKEN=your_github_token_here

Add to your MCP client configuration (e.g., Claude Desktop):

{ "mcpServers": { "github-webhooks": { "command": "node", "args": ["/path/to/github-webhooks-mcp-server/dist/index.js"], "env": { "GITHUB_TOKEN": "your_github_token_here" } } } }

{ "org": "my-org", "config": { "url": "https://example.com/webhook", "content_type": "json", "secret": "my-secret" }, "events": ["push", "pull_request"], "active": true }

{ "org": "my-org", "per_page": 30, "page": 1 }

{ "org": "my-org", "hook_id": 12345, "config": { "url": "https://example.com/new-webhook" }, "active": false }

{ "org": "my-org", "hook_id": 12345 }

{ "owner": "username", "repo": "repository-name", "config": { "url": "https://example.com/webhook", "content_type": "json" }, "events": ["push", "issues"], "active": true }

{ "owner": "username", "repo": "repository-name" }

{ "owner": "username", "repo": "repository-name", "hook_id": 12345, "events": ["push", "pull_request", "issues"] }

{ "owner": "username", "repo": "repository-name", "hook_id": 12345 }

- push- Git push to a repository
- pull_request- Pull request activity
- issues- Issue activity
- issue_comment- Issue comment activity
- release- Release activity
- create- Branch or tag created
- delete- Branch or tag deleted
- fork- Repository forked
- star- Repository starred
- watch- Repository watched

For a complete list of events, seeGitHub Webhook Events Documentation.

github-webhooks-mcp-server/ ├── src/ │ └── index.ts # Main server implementation ├── dist/ # Compiled JavaScript (generated) ├── package.json ├── tsconfig.json └── README.md

Manage GitHub repositories using a personal access token via CLI or environment variables.