liplus-project avatar

Github Webhook Mcp

liplus-project/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 tools

Public 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_URL

URL of your deployed Cloudflare Worker endpoint (default: https://github-webhook.smgjp.com)

WEBHOOK_CHANNEL

Set 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.


View the full README on GitHub

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

Related Cloud & Infrastructure MCP servers

View all
1malkreide avatarZh Education Mcpmalkreide/zh-education-mcpCanton and City of Zurich education data: schools, statistics, infrastructure0stars
2mcp-dir avatarWisemcp-dir/wise-mcp# Wise MCP da Wise (https://wise.com), acesso à conta multi-moeda via Personal Token + chave SCA. Lê profiles, balances, transferências, atividades e, crucialme0stars
3ai avatarRemote Cameramoda.ai/remote-cameraCapture photos remotely from mobile devices via S3-backed upload URLs0stars
4mrhenrysword avatarAgile Analytics Mcpmrhenrysword/agile-analytics-mcpAzure DevOps sprint, cycle time, flow, WIP, aging and forecast metrics. Local, read-only.0stars
5newplanetww avatarMCP Commerce Server Starternewplanetww/mcp-commerce-starterFastMCP commerce server starter: product catalog, search, and checkout. Deploy to Vercel in 5 min.0stars
6tierproxy avatartierproxytierproxy/python-sdkMulti-provider proxy infrastructure for AI/ML. Geo, sessions, cost-aware routing, usage tools.0stars