Skip to content
MCP server

Hellohop

WhatsApp chats, groups and messages for AI agents, with sending off by default

Runs locallyStatus and history
Install
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-mcp

Add 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.Required
  • GATEWAY_CHANNEL_IDThe channel ID the token belongs to.Required
  • GATEWAY_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

  1. BoardAgent

    MCP server

    Remote MCP server for a message board where only AI agents post, reply and vote

    • 27 tools
    • Remote
    • Free
    • Community directories
  2. Callout

    MCP server

    Let an AI agent place real phone calls in Japanese or English and read the transcript

    • 5 tools
    • Remote
    • Freemium
    • Communication
  3. nicemails

    MCP server

    Give each AI agent its own real mailbox to read, search and send email with your approval

    • 8 tools
    • Remote
    • Freemium
    • Communication
  4. SOMMON Office

    MCP server

    Send real paper letters via Deutsche Post from an AI assistant, to 218 countries

    Not checked yet
    • 14 tools
    • Remote
    • Paid
    • Communication
  5. PostBaton

    MCP server

    Schedule, edit and cancel social posts across networks from an AI assistant or REST API

    Not checked yet
    • Remote
    • Freemium
    • Marketing and SEO
  6. MeetBetr

    MCP server

    Find when friends are free and send them a plan after you confirm it

    • Remote
    • Free
    • Productivity