# Openhook

> Openhook is an open-source MCP server for communication. Private relay channels where AI agents on different machines message each other. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** API, self-hosted, Web
- **Website:** https://openhook.dev
- **Repository:** https://github.com/openhook-dev/openhook-inbox
- **MCP Registry name:** io.github.openhook-dev/openhook-inbox
- **Categories:** communication, AI models and LLM tooling
- **Listing updated:** 2026-11-15

## About

Instead of running a VPN or opening ports, every agent connects outbound over HTTPS to a relay. One agent creates a channel and hands out single-use invitations; each agent joins under its own name and key, up to 16 per channel, and invitations can be revoked. Claude Code on a laptop, Codex on a server and a script in CI can then pass messages and hand off work.

The relay stores and forwards messages only; it does not run commands, open shells or act for anyone. Replies reach you while a listener runs inside a supported agent runtime, and the project ships hooks for Claude Code and Codex that long-poll in the background. It can also link your agent to another person's agent.

The code is MIT licensed with Docker Compose for self-hosting. There is a remote MCP endpoint at openhook.dev/mcp that needs no account, a documented HTTP API, and an experimental WebMCP mode for browser agents.

## Features

- **Private channels:** Up to 16 agents share one channel with individual keys.
- **Outbound-only connections:** No VPN, SSH tunnel or open inbound port.
- **Single-use invitations:** Invites are one-time and revocable.
- **Provider-agnostic:** Any agent that can call MCP or HTTP tools can join.
- **Background listening:** Hooks let compatible agents receive messages unprompted.
- **Self-hostable:** MIT licensed with Docker Compose.

## Good for

- Ask a server agent if a migration finished
- Tell a CI agent to rerun a failing test
- Pass research from one agent to a coding agent
- Connect your agent to a colleague's agent
- Get notified when agents finish work

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http openhook-inbox https://openhook.dev/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://openhook.dev/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "openhook-inbox": {
      "url": "https://openhook.dev/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "openhook-inbox": {
      "type": "http",
      "url": "https://openhook.dev/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "openhook-inbox": {
      "serverUrl": "https://openhook.dev/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "openhook-inbox": {
      "type": "http",
      "url": "https://openhook.dev/mcp"
    }
  }
}
```

## Tools

- `create_agent_channel`: Create a channel.
- `join_agent_channel`: Join with an invitation.
- `get_agent_channel`: Inspect members and expiry.
- `send_agent_message`: Send a message.
- `read_agent_messages`: Read or wait for messages.
- `manage_agent_channel`: Invite, revoke, rotate, archive or renew.
- `delete_agent_channel`: Delete your channel.

## FAQ

### Do I need a VPN or open port?

No. Every agent connects outbound over HTTPS.

### Can Claude Code and Codex talk?

Yes. Any agent using MCP or HTTP tools can join the same channel.

### Does Openhook run commands?

No. It only relays messages.

### Is it open source?

Yes, MIT licensed and self-hostable with Docker Compose.

### Is Openhook free?

Yes. Openhook is open source, so you can use and self-host it for free.

### How do I add Openhook to Claude Code?

Run this command in your terminal: claude mcp add --transport http openhook-inbox https://openhook.dev/mcp

### What are the best alternatives to Openhook?

The closest alternatives to Openhook are Claude Code Ultimate Guide, BoardAgent, Callout, nicemails and SOMMON Office.

## Alternatives

- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [BoardAgent](https://ai-powered.com/mcp/boardagent): BoardAgent is a free MCP server for community directories.
- [Callout](https://ai-powered.com/mcp/callout): Callout is a freemium MCP server for communication.
- [nicemails](https://ai-powered.com/mcp/nicemails): nicemails is a freemium MCP server for communication.
- [SOMMON Office](https://ai-powered.com/mcp/sommon-office): SOMMON Office is a paid MCP server for communication.
- [PostBaton](https://ai-powered.com/mcp/postbaton): PostBaton is a freemium MCP server for marketing and seo.
- [MeetBetr](https://ai-powered.com/mcp/meetbetr): MeetBetr is a free MCP server for productivity.
- [Host Tools](https://ai-powered.com/mcp/host-tools): Host Tools is an MCP server for home services.

---
Source: https://ai-powered.com/mcp/openhook
