# Hellohop

> Hellohop is a paid MCP server for communication. WhatsApp chats, groups and messages for AI agents, with sending off by default. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Paid
- **Starting price:** $25 a month
- **Platforms:** API, CLI
- **Website:** https://hellohop.app/docs/mcp
- **Repository:** https://github.com/socialgroundco/hellohop-mcp
- **MCP Registry name:** app.hellohop/hellohop
- **Categories:** communication
- **Listing updated:** 2026-11-14

## About

HelloHop is a WhatsApp API for developers, and this server connects an MCP client to one channel of it. It needs a channel ID and an API token, and runs with npx on Node.js 22 or later. The read tools cover channel status, up to 100 observed chats, recent messages (default 50, at most 500 per call), groups, communities, community subgroups and a stored contact.

Sending is switched off until you set GATEWAY_ALLOW_SEND to 1. When enabled, an agent can send text, media by URL, polls and reactions, remove a reaction, or delete a message the number sent within 48 hours. A separate check_numbers tool is always available and sends no message; it starts background number checks of 1 to 50 numbers that can take hours or days.

Group and community calls query WhatsApp directly, so the docs warn against polling them. HelloHop says it is not affiliated with WhatsApp or Meta.

## Features

- **Read-only by default:** Sending tools stay disabled until GATEWAY_ALLOW_SEND is set to 1.
- **Message history:** read_messages pages back through a chat, up to 500 messages per call.
- **Groups and communities:** List groups, fetch group or community details and list community subgroups.
- **Polls, media and reactions:** When enabled, send media by URL, create polls of 2 to 12 options and react to messages.
- **Number checks:** check_numbers verifies 1 to 50 numbers in the background without sending messages.
- **Capability snapshot:** channel_status reports which features the number currently supports.

## Good for

- Summarise a WhatsApp group's recent conversation
- List the groups a number belongs to
- Look up a stored contact before replying
- Post a poll to a group once sending is enabled
- Check whether numbers are on WhatsApp

## Install

### Claude Code (Terminal)

```sh
claude mcp add hellohop --env GATEWAY_API_TOKEN='<GATEWAY_API_TOKEN>' --env GATEWAY_CHANNEL_ID='<GATEWAY_CHANNEL_ID>' -- npx -y hellohop-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "hellohop": {
      "command": "npx",
      "args": [
        "-y",
        "hellohop-mcp"
      ],
      "env": {
        "GATEWAY_API_TOKEN": "<GATEWAY_API_TOKEN>",
        "GATEWAY_CHANNEL_ID": "<GATEWAY_CHANNEL_ID>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "hellohop": {
      "command": "npx",
      "args": [
        "-y",
        "hellohop-mcp"
      ],
      "env": {
        "GATEWAY_API_TOKEN": "<GATEWAY_API_TOKEN>",
        "GATEWAY_CHANNEL_ID": "<GATEWAY_CHANNEL_ID>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "hellohop": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "hellohop-mcp"
      ],
      "env": {
        "GATEWAY_API_TOKEN": "<GATEWAY_API_TOKEN>",
        "GATEWAY_CHANNEL_ID": "<GATEWAY_CHANNEL_ID>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "hellohop": {
      "command": "npx",
      "args": [
        "-y",
        "hellohop-mcp"
      ],
      "env": {
        "GATEWAY_API_TOKEN": "<GATEWAY_API_TOKEN>",
        "GATEWAY_CHANNEL_ID": "<GATEWAY_CHANNEL_ID>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "hellohop": {
      "command": "npx",
      "args": [
        "-y",
        "hellohop-mcp"
      ],
      "env": {
        "GATEWAY_API_TOKEN": "<GATEWAY_API_TOKEN>",
        "GATEWAY_CHANNEL_ID": "<GATEWAY_CHANNEL_ID>"
      }
    }
  }
}
```

## Tools

- `channel_status`: Read the channel's status, optionally with safety info.
- `list_chats`: List up to 100 chats from the channel's log.
- `read_messages`: Read recent messages in a chat.
- `list_groups`: List the number's WhatsApp groups.
- `get_group`: Get one group.
- `get_community`: Get one community.
- `list_community_subgroups`: List subgroups of a community.
- `get_contact`: Read a stored contact entry.
- `send_text`: Send a text message (needs sending enabled).
- `send_media`: Send media by URL (needs sending enabled).
- `send_poll`: Send a poll (needs sending enabled).
- `react`: React to a message (needs sending enabled).
- `unreact`: Remove a reaction (needs sending enabled).
- `delete_message`: Delete a sent message within 48 hours (needs sending enabled).
- `check_numbers`: Start or read a background number check.

## FAQ

### Can the agent send messages right away?

No. Send tools are off by default and need GATEWAY_ALLOW_SEND set to 1 or true.

### What does it cost?

The README says HelloHop starts at $25 USD per number per month with a free sandbox.

### What do I need to run it?

Node.js 22 or later, a channel ID and the channel's API token.

### Why not poll the group tools?

They ask WhatsApp, and a throttled number answers 429 whatsapp_rate_limited.

### Is Hellohop free?

No. Hellohop is a paid product. Paid plans start at $25 a month.

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

Run this command in your terminal: claude mcp add hellohop --env GATEWAY_API_TOKEN='<GATEWAY_API_TOKEN>' --env GATEWAY_CHANNEL_ID='<GATEWAY_CHANNEL_ID>' -- npx -y hellohop-mcp

### What are the best alternatives to Hellohop?

The closest alternatives to Hellohop are BoardAgent, Callout, nicemails, SOMMON Office and PostBaton.

## Alternatives

- [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.
- [iMessage MCP](https://ai-powered.com/mcp/imessage-mcp): iMessage MCP is an open-source MCP server for communication.

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