hookdeck-cli

Overview

Hookdeck CLI is primarily a robust tool for forwarding webhooks to localhost with unlimited free and permanent event URLs, serving as an ngrok alternative. It provides comprehensive management of Hookdeck Event Gateway resources including sources, connections, destinations, events, and transformations. The CLI includes a built-in MCP server that exposes these capabilities as tools in MCP-compatible clients like Cursor and Claude, making it particularly valuable for AI workflows. The interface is well-designed with an interactive TUI showing event history, allowing replay, filtering, and detailed inspection of requests/responses.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• list_sources

  List all event sources in the Hookdeck Event Gateway

  Try:Show me all my webhook sourcesTry:List all sources in my Hookdeck account
• list_destinations

  List all destinations in the Hookdeck Event Gateway

  Try:Show me all my destinationsTry:List all endpoints I can send events to
• list_connections

  List all connections between sources and destinations

  Try:Show me all my connectionsTry:List how sources are connected to destinations
• create_source

  Create a new event source in Hookdeck

  Try:Create a new GitHub source for my webhookTry:Add a new Stripe source to my account
• create_destination

  Create a new destination for events in Hookdeck

  Try:Create a new destination pointing to localhost:3000Try:Add a webhook endpoint destination
• create_connection

  Create a new connection between a source and destination

  Try:Connect my GitHub source to my localhost destinationTry:Create a connection from Shopify to my production API
• update_connection

  Update an existing connection between source and destination

  Try:Update my connection to add filtering rulesTry:Modify the path for my GitHub connection
• delete_connection

  Delete an existing connection in Hookdeck

  Try:Remove the connection between my GitHub source and localhostTry:Delete the connection from Shopify to my production API
• list_events

  List events that have been processed through the Event Gateway

  Try:Show me the events from the last hourTry:List all events from my GitHub source
• create_transformation

  Create a new transformation to modify event data

  Try:Create a transformation to add my API key to request headersTry:Set up a transformation to normalize event payloads
• listen_events

  Listen to events from a source or connection

  Try:Listen to events from my Stripe sourceTry:Forward events from GitHub to my local development server
• replay_event

  Replay a previously processed event

  Try:Replay that failed event to my local serverTry:Send that Shopify order event again

Comparable tools

Installation

# NPM
npm install hookdeck-cli -g

# macOS
brew install hookdeck/hookdeck/hookdeck

# Windows
scoop bucket add hookdeck https://github.com/hookdeck/scoop-hookdeck-cli.git
scoop install hookdeck

# Linux
tar -xvf hookdeck_X.X.X_linux_amd64.tar.gz
./hookdeck

{
  "mcpServers": {
    "hookdeck": {
      "command": "hookdeck",
      "args": ["gateway", "mcp"]
    }
  }
}

FAQ

What is the difference between Hookdeck CLI and ngrok?

Hookdeck CLI provides unlimited free permanent URLs, preserves event history between sessions, supports filtering and fan-out delivery, and includes resource management capabilities through a CLI.

How does the MCP server integrate with AI agents?

The Event Gateway MCP server (`hookdeck gateway mcp`) exposes Hookdeck's webhook and event management capabilities as tools in MCP-compatible clients like Cursor and Claude, allowing AI agents to interact with your event infrastructure.

Compare hookdeck-cli with