openwebhook

OpenWebhook CLI

Receive webhooks on 127.0.0.1 without a tunnel. The first run does not need an account. Requires Node.js 20.9 or later.

npm install --global openwebhook
openwebhook listen --port 3001

The CLI prints a temporary URL on hooks.openwebhook.co and forwards each request to 127.0.0.1:3001. The public URL returns that local status and body while listen is connected. That URL expires after 24 hours. The anonymous device token in ~/.openwebhook/config.json (directory 0700, file 0600) does not.

OPENWEBHOOK_CONFIG overrides the path. An existing ~/.config/openwebhook/config.json with an owh_live_ token is still read.

Permanent slugs

A Pro token keeps a stable URL such as https://hooks.openwebhook.co/billing.

openwebhook auth owh_live_…
openwebhook listen billing --port 3001

Generate the token once in the developer dashboard. OPENWEBHOOK_TOKEN can supply it without writing it to disk. auth writes the argument to the config file and links the device with that token, even if OPENWEBHOOK_TOKEN is set. listen and mcp still prefer the environment variable when it is present.

The local host is always 127.0.0.1. The port comes only from --port. Absolute paths, protocol-relative URLs, backslashes, and newlines are rejected.

MCP

openwebhook mcp

No token is required for url.inspect or for watching the anonymous URL. Permanent slugs need Pro. The process speaks JSON-RPC on stdio and does not write logs to stdout.

Tool	Without an account	With Pro
url.inspect	Temporary ingest URL	Same
watch.start / watch.stop / watch.wait / watch.list	Anonymous URL	Also a named slug
endpoint.list / endpoint.create / endpoint.delete	Asks for an account	Named slugs

watch keeps an in-memory buffer of up to 100 events. Nothing is written to disk.

{
  "mcpServers": {
    "openwebhook": {
      "command": "openwebhook",
      "args": ["mcp"]
    }
  }
}

Add OPENWEBHOOK_TOKEN only when you want named slugs.

The server is listed as co.openwebhook/mcp in the MCP Registry and as a local stdio bundle on Smithery. Install it with npm or npx -y openwebhook mcp.

Claude Desktop

Install the Desktop Extension (.mcpb) from a release, or build it from this repository with npm run package:mcpb. Leave the token field empty for an anonymous URL. Paste a Pro token only for permanent slugs.

Environment

Variable	Purpose
OPENWEBHOOK_API_URL	API origin (https://openwebhook.co). HTTP(S) only, no credentials.
OPENWEBHOOK_TOKEN	Pro token instead of the config file
OPENWEBHOOK_DEVICE_TOKEN	Device token instead of the config file
OPENWEBHOOK_CONFIG	Alternate config path

Privacy

https://openwebhook.co/privacy