webhook

claude-channel-webhook

A Claude Code channel plugin that bridges an HTTP polling API to a live Claude Code session. Designed for use with iPhone Shortcuts (or any HTTP client) that can't hold a persistent connection.

How it works

1. Client POST /send → server delivers message to Claude via MCP channel notification → returns job_id
2. Client polls GET /result/{job_id} until Claude responds via the reply tool
3. Claude's response is returned and the job is cleaned up

Prerequisites

• Bun runtime
• Claude Code ≥ 2.1.80 with a claude.ai account (channels are in research preview)

Installation

claude plugin install https://github.com/your-username/claude-channel-webhook

Then enable it in ~/.claude/settings.json:

{
  "enabledPlugins": {
    "webhook@your-marketplace": true
  }
}

Configuration

Edit .mcp.json (or set env vars on your system) before starting:

Variable	Default	Description
WEBHOOK_PORT	8000	Port the HTTP server listens on
WEBHOOK_SECRET	—	Required. Shared secret; set to a strong random value

Starting a session

Channels are in research preview and require a bypass flag:

claude --dangerously-load-development-channels plugin:webhook@your-marketplace

API

POST /send

{ "token": "<WEBHOOK_SECRET>", "text": "your message" }

Response:

{ "ok": true, "job_id": "<uuid>" }

GET /result/{job_id}

Returns { "status": "pending" } while Claude is thinking, or:

{ "status": "done", "reply": "Claude's response" }

The job is deleted after the first successful read.

iPhone Shortcut

Set up a shortcut with two actions:

1. Get contents of URL — POST https://your-host:8000/send with JSON body {"token":"…","text":"[Shortcut Input]"}
2. Loop Get contents of URL — GET https://your-host:8000/result/[job_id] every 2 s until status is done
3. Return reply