
Github Webhook Mcp
Connects Claude to GitHub events through Cloudflare Workers instead of running a local webhook receiver. Install the GitHub App on your repos, then use MCP tools like get_pending_status, list_pending_events, and mark_processed to query and triage webhooks stored in a Durable Object. Handles push, pull request, and check run events with optional WebSocket streaming for real-time notifications in Claude Code CLI. The local bridge polls the edge storage over HTTP, so no tunneling or exposed ports. Useful when you want Claude to monitor CI results, PR activity, or commit notifications without setting up ngrok or a dedicated server.
- tools
- 5
- transport
- STDIO
- env vars
- 2
- last updated
- Apr 2, 2026
Tools
5 toolsPublic tool metadata for what this MCP can expose to an agent.
get_pending_statusLightweight snapshot of pending event counts by type
Lightweight snapshot of pending event counts by type
No parameter schema in public metadata yet.
list_pending_eventsSummaries of pending events (no full payloads)
Summaries of pending events (no full payloads)
No parameter schema in public metadata yet.
get_eventFull payload for a single event by ID
Full payload for a single event by ID
No parameter schema in public metadata yet.
get_webhook_eventsFull payloads for all pending events
Full payloads for all pending events
No parameter schema in public metadata yet.
mark_processedMark events as processed (`event_id` for one, `event_ids` for a batch)
Mark events as processed (`event_id` for one, `event_ids` for a batch)
No parameter schema in public metadata yet.
Sponsors
Configuration
WEBHOOK_WORKER_URLURL of your deployed Cloudflare Worker endpoint (default: https://github-webhook.smgjp.com)
WEBHOOK_CHANNELSet to '0' to disable SSE channel notifications (default: enabled)
Readme
github-webhook-mcp
Real-time GitHub webhook notifications for Claude via Cloudflare Worker + Durable Object.
Architecture
GitHub ──POST──▶ Cloudflare Worker ──▶ Durable Object (SQLite)
│
├── MCP tools (Streamable HTTP)
├── WebSocket real-time stream
│
┌────────────────┘
│
Desktop / Codex: .mcpb local bridge ──▶ polling via MCP tools
Claude Code CLI: .mcpb local bridge ──▶ WebSocket → channel notifications
- Cloudflare Worker receives GitHub webhooks, verifies signatures, stores events in a Durable Object with SQLite.
- Local MCP bridge (.mcpb) proxies tool calls to the Worker and optionally connects via WebSocket for real-time channel notifications.
- No local webhook receiver or tunnel required.
Breaking change: MCP protocol revision 2026-07-28
From this release the Worker serves MCP protocol revision 2026-07-28 only. It keeps no compatibility lane for the previous revision.
Details
- Repository
- github.com/liplus-project/github-webhook-mcp
- Categories
- Cloud & Infrastructure, Developer Tools, Automation & Workflows, Media & Entertainment
- Package
github-webhook-mcp- Transport
- STDIO
- Registry
- MCP registry, active