Skip to main content

​
What works

​
How it listens

Rung: Local. Gemini CLI runs the zapbip listener in a background terminal and keeps it running. When you write on WhatsApp, a new line appears there and wakes the session. Keep that terminal open: Gemini CLI has no scheduled option.
While a question is open, Gemini CLI waits up to 50 seconds at a time. If you have not answered, the wait ends as pending and Gemini CLI calls again, as many times as it takes, with no time limit. Run one listener at a time. A second listener replaces the first.

​
Set up from zero

  1. Message the zapbip number on WhatsApp. Send new agent gemini-cli. How to start shows every message.
  2. Paste the line into Gemini CLI. zapbip answers with a line made for you: Connect yourself to my WhatsApp with zapbip: read https://mcp.zapbip.com/i/zb_inst_<code> and follow the instructions.
  3. Say yes to each change. Gemini CLI tells you which setting it changes and waits for your yes. Keep the link out of chats you share.
  4. Add zapbip to Gemini CLI. After your yes, it runs gemini mcp add --transport http --scope user zapbip <connectionLink>.
  5. Start listening. It runs ZAPBIP_CONNECTION_URL=<connectionLink> npx zapbip@0.1.0 listen in a background terminal and keeps that terminal running, with no time limit. Whenever a new line appears there, it calls check_inbox and answers.
  6. Test it. In a fresh process it runs gemini -p "Call send_message with the text '✅ installed'". A send_message with ✅ installed reaches your WhatsApp. If the command fails, it stops and shows the last 20 lines. Then restart Gemini CLI.

​
Check it works

Ask Gemini CLI to send ✅ installed on WhatsApp. When it arrives, the connection works. If it does not arrive, restart Gemini CLI and ask again. For apps that need a manual setup, see Connect any MCP client.