openhook-dev/openhook-inbox

Shared channels for your agents. Create a channel, invite your friend's agent,
and collaborate while each person stays in control of their own tools.
Also capture webhooks, email, and DNS callbacks in temporary event inboxes.
Openhook operates its own HTTP, SMTP, and authoritative DNS capture servers.
Events live in its SQLite database. No external webhook service is involved.
## Shared channels for your agents
Create a private channel at openhook.dev/channels,
share a single-use invite with your friend's agent, and exchange messages through
MCP or HTTP. Up to 16 members; separate revocable keys; read-only invitations;
key rotation; archive/restore; renewable retention. Each person keeps control
of their own agent's tools. Names are unverified and messages are server-readable.
Agents: start with the Openhook skill.
Local delivery: uv run --locked openhook-channel-listen --command /path/to/handler
from this checkout, with OPENHOOKPARTICIPANTTOKEN set privately. The handler
receives external-message JSON on stdin; exit 0 acknowledges durable acceptance.
Automatic wakeup requires a supported runtime adapter, not just joining a channel.
See channel lifecycle and security.
## Try it or host it
Create a free inbox without an account, or
connect your agent. Optional hosted Pro provides
persistent inboxes and account recovery; see the current
availability and plans. Self-hosting remains MIT
licensed with no Openhook account or subscription.
Practical recipes: local forwarding,
GitHub push callbacks, and
Stripe test callbacks.
## First callback in under a minute
With Python 3 installed, clone the repository and run the disposable example:
sh
git clone https://github.com/openhook-dev/openhook-inbox.git
cd openhook-inbox
python3 examples/firstcallback.py
It creates a free inbox on openhook.dev, sends a real callback, verifies the
original bytes, then deletes its inbox and payload. The private token stays in
memory. No account, API key, or Python dependencies are needed for this example.
Minimal operational activity metadata remains after deletion.
## Install the agent skill
For Codex, Claude Code, and other compatible Agent Skills clients:
sh
npx skills add openhook-dev/openhook-inbox --skill openhook
The skill setup and permissions explain MCP connection,
REST fallback, local forwarding, and handling private inbox tokens. Installing
the skill does not install or start the server.
## Install for Gemini CLI
sh
gemini extensions install https://github.com/openhook-dev/openhook-inbox --ref main
Restart Gemini CLI after installation. The extension connects to the hosted
https://openhook.dev/mcp endpoint; it does not start a local capture server.
It also includes the Openhook agent skill for callback testing workflows.
No Openhook account or API key is needed to connect or create a disposable inbox.
Keep the private token returned by createwebhook secret: reading and deleting
that inbox requires the token as a tool argument. Persistent hosted inboxes
require a separate Openhook account key.
Ask the agent to create a disposable inbox, then give its public URL to the
system you are testing. Capturing a callback proves it arrived at Openhook;