Hookdeck CLI
CLI for Hookdeck: forward webhooks to localhost (ngrok alternative), manage and query Event Gateway resources (sources, connections, destinations, events), run the MCP server for AI agents. Free for dev.
What is Hookdeck CLI?
Hookdeck CLI is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to cli for hookdeck: forward webhooks to localhost (ngrok alternative), manage and query event gateway resources (sources, connections, destinations, events), run the mcp server for ai agents. free for d...
CLI for Hookdeck: forward webhooks to localhost (ngrok alternative), manage and query Event Gateway resources (sources, connections, destinations, events), run the MCP server for AI agents. Free for dev.
This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- CLI for Hookdeck: forward webhooks to localhost (ngrok alter
Use Cases
Maintainer
Works with
Installation
NPM
npx -y hookdeck-cliManual Installation
npx -y hookdeck-cliConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Hookdeck CLI
Hookdeck CLI is a developer tool for forwarding webhooks from the internet to your local development server — a free alternative to ngrok for webhook development — and also provides an MCP server that exposes Hookdeck's Event Gateway resources to AI agents. Through the MCP interface, AI assistants can inspect webhook sources, connections, destinations, events, delivery attempts, transformation logic, and failure metrics. Teams use it to debug webhook pipelines, investigate delivery failures, and automate Event Gateway management without leaving their AI assistant.
Prerequisites
- A Hookdeck account (free tier available at hookdeck.com)
- Hookdeck API key from the Hookdeck dashboard
- The Hookdeck CLI installed on your machine (via npm, Homebrew, Scoop, or binary download)
- An MCP-compatible client such as Claude Desktop, Cursor, or Claude Code
- Node.js 18+ if installing via npm
Install the Hookdeck CLI
Install the CLI using your preferred method. npm is the most portable option; Homebrew is recommended on macOS.
# npm (cross-platform)
npm install -g hookdeck-cli
# macOS with Homebrew
brew install hookdeck
# Or run without installing via npx
npx -y hookdeck-cliAuthenticate with your Hookdeck account
Log in using the CLI. This stores your API key in the local config file (~/.config/hookdeck/config.toml on macOS/Linux). Alternatively, set the HOOKDECK_API_KEY environment variable for CI/CD environments.
hookdeck loginVerify CLI access to your project
Confirm the CLI can reach your Hookdeck project by listing your sources. This also confirms the API key is correctly configured before setting up the MCP server.
hookdeck get sourcesConfigure the MCP server in your client
Add the Hookdeck MCP server to your MCP client configuration. The server is launched using the local hookdeck binary with the 'gateway mcp' subcommand — no separate package needed.
{
"mcpServers": {
"hookdeck": {
"command": "hookdeck",
"args": ["gateway", "mcp"],
"env": {
"HOOKDECK_API_KEY": "api_key_xxxxxxxxxxxxxxxxxxxx"
}
}
}
}Restart your MCP client and verify
Restart your MCP client. Ask the AI to list your Hookdeck projects or show recent events to confirm the MCP connection is active.
Hookdeck CLI Examples
Client configuration
claude_desktop_config.json configuration for the Hookdeck CLI MCP server using the installed binary.
{
"mcpServers": {
"hookdeck": {
"command": "hookdeck",
"args": ["gateway", "mcp"],
"env": {
"HOOKDECK_API_KEY": "api_key_xxxxxxxxxxxxxxxxxxxx"
}
}
}
}Prompts to try
Example AI assistant queries you can run once the Hookdeck CLI MCP server is configured.
- "Are any of my webhook events failing right now? Show me the errors"
- "What is the delivery success rate for my Stripe webhook source over the past 24 hours?"
- "List all connections that are currently paused"
- "Show me the last 10 failed delivery attempts to my payments-service destination"
- "What transformations are applied to events coming from my GitHub source?"Troubleshooting Hookdeck CLI
'hookdeck: command not found' when MCP client tries to start the server
The MCP client may not inherit your shell PATH. Use the full absolute path to the hookdeck binary (e.g. /usr/local/bin/hookdeck) in the command field, or install via npm globally and use 'npx hookdeck-cli' as the command with 'gateway mcp' as args.
Authentication errors when querying Event Gateway resources
Set HOOKDECK_API_KEY explicitly in the env block of your MCP config rather than relying on the stored config file, since GUI-launched MCP clients may not read ~/.config/hookdeck/config.toml. Get your API key from the Hookdeck dashboard under Settings > API Keys.
MCP server starts but returns no projects or empty results
Run 'hookdeck projects list' in your terminal to verify the API key has access to projects. If you have multiple workspaces, use hookdeck_projects to switch to the correct project within your AI conversation.
Frequently Asked Questions about Hookdeck CLI
What is Hookdeck CLI?
Hookdeck CLI is a Model Context Protocol (MCP) server that cli for hookdeck: forward webhooks to localhost (ngrok alternative), manage and query event gateway resources (sources, connections, destinations, events), run the mcp server for ai agents. free for dev. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Hookdeck CLI?
Install via npm with the command: npx -y hookdeck-cli. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).
Which AI clients work with Hookdeck CLI?
Hookdeck CLI works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Hookdeck CLI free to use?
Yes, Hookdeck CLI is open source and available under the Apache-2.0 license. You can use it freely in both personal and commercial projects.
Hookdeck CLI Alternatives — Similar Developer Tools Servers
Looking for alternatives to Hookdeck CLI? Here are other popular developer tools servers you can use with Claude, Cursor, and VS Code.
Ecc
★ 188.2kThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
Javaguide
★ 155.8kJava 面试 & 后端通用面试指南，覆盖计算机基础、数据库、分布式、高并发、系统设计与 AI 应用开发
Gemini CLI
★ 104.5kA secure MCP server that wraps the Google Gemini CLI, allowing clients to query Gemini models using local OAuth sessions without requiring an API key. It provides tools for model interaction and diagnostics with built-in protection against command in
Awesome MCP Servers
★ 87.3k⭐ Curated list of Model Context Protocol (MCP) servers - tools that extend Claude Desktop, Cursor, Windsurf, and other MCP clients with custom capabilities.
MCP Servers
★ 86.0kModel Context Protocol Servers
CC Switch
★ 77.5kA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io
Browse More Developer Tools MCP Servers
Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Hookdeck CLI in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Hookdeck CLI?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.