Hellohop
WhatsApp chats, groups and messages for AI agents, with sending off by default
- Pricing
- Paid
- Platforms
- API, CLI
- Runs
- Locally
- Version
- 0.3.2
- Listing updated
- 3 days ago
About Hellohop
Hellohop is a paid MCP server for communication. It runs locally on your machine and is started by your AI client.
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.
Install
Run in a terminal
claude mcp add hellohop --env GATEWAY_API_TOKEN='<GATEWAY_API_TOKEN>' --env GATEWAY_CHANNEL_ID='<GATEWAY_CHANNEL_ID>' -- npx -y hellohop-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"hellohop": {
"command": "npx",
"args": [
"-y",
"hellohop-mcp"
],
"env": {
"GATEWAY_API_TOKEN": "<GATEWAY_API_TOKEN>",
"GATEWAY_CHANNEL_ID": "<GATEWAY_CHANNEL_ID>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"hellohop": {
"command": "npx",
"args": [
"-y",
"hellohop-mcp"
],
"env": {
"GATEWAY_API_TOKEN": "<GATEWAY_API_TOKEN>",
"GATEWAY_CHANNEL_ID": "<GATEWAY_CHANNEL_ID>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"hellohop": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"hellohop-mcp"
],
"env": {
"GATEWAY_API_TOKEN": "<GATEWAY_API_TOKEN>",
"GATEWAY_CHANNEL_ID": "<GATEWAY_CHANNEL_ID>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"hellohop": {
"command": "npx",
"args": [
"-y",
"hellohop-mcp"
],
"env": {
"GATEWAY_API_TOKEN": "<GATEWAY_API_TOKEN>",
"GATEWAY_CHANNEL_ID": "<GATEWAY_CHANNEL_ID>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"hellohop": {
"command": "npx",
"args": [
"-y",
"hellohop-mcp"
],
"env": {
"GATEWAY_API_TOKEN": "<GATEWAY_API_TOKEN>",
"GATEWAY_CHANNEL_ID": "<GATEWAY_CHANNEL_ID>"
}
}
}
}Configuration
GATEWAY_API_TOKENThe channel's API token.RequiredGATEWAY_CHANNEL_IDThe channel ID the token belongs to.RequiredGATEWAY_ALLOW_SENDSet to 1 or true to enable the send tools. Off by default.GATEWAY_API_URLAPI base URL. Defaults to https://api.hellohop.app/v1.
Tools this server provides (15)
Taken from the project documentation; the running server may differ.
- 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.
What it does
- 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
Pricing
Paid, from $25 a month
HelloHop API from $25/number/month; free sandbox
Prices change. Check hellohop.app before you buy.
Hellohop 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 to Hellohop

BoardAgent
MCP serverRemote MCP server for a message board where only AI agents post, reply and vote
- 27 tools
- Remote
- Free
- Community directories

Callout
MCP serverLet an AI agent place real phone calls in Japanese or English and read the transcript
- 5 tools
- Remote
- Freemium
- Communication

nicemails
MCP serverGive each AI agent its own real mailbox to read, search and send email with your approval
- 8 tools
- Remote
- Freemium
- Communication

SOMMON Office
MCP serverSend real paper letters via Deutsche Post from an AI assistant, to 218 countries
Not checked yet- 14 tools
- Remote
- Paid
- Communication

PostBaton
MCP serverSchedule, edit and cancel social posts across networks from an AI assistant or REST API
Not checked yet- Remote
- Freemium
- Marketing and SEO

MeetBetr
MCP serverFind when friends are free and send them a plan after you confirm it
- Remote
- Free
- Productivity