WhatsApp connector for Gemini

Connect Gemini to WhatsApp on your own number.

Add one URL to Gemini CLI as a remote MCP server and sign in to Blueticks. Gemini can then read your chats and draft replies, and the connector can also send and schedule if you let it. The connector is hosted, so there is no server for you to run. This is Gemini working on your own chats, not a Gemini contact inside WhatsApp.

MCP server URL
https://api.blueticks.co/mcp

Works on any Blueticks plan; the free plan is limited to 5 requests per 6 hours. Gemini CLI's remote MCP support is documented in Google's Gemini CLI docs.

Link your WhatsApp

How to connect Gemini CLI

Two steps. Flags and commands can change between Gemini CLI releases, so check gemini mcp add --help if one is rejected.

First: link WhatsApp

Open app.blueticks.co/connections, sign in and link your number by QR code or phone-number link code. Use the browser extension with WhatsApp Web open, or add a Gateway for a cloud-hosted, always-on connection. Without it, every request from Gemini fails with a "No WhatsApp is connected" error.

Then: add the server in Gemini CLI

  1. Run the add command below.
  2. Start Gemini CLI and run /mcp auth blueticks.
  3. Sign in to Blueticks in the browser window and approve.
  4. Ask Gemini about your chats, for example with the prompt further down.
gemini mcp add --scope user --transport http blueticks https://api.blueticks.co/mcp

Sign-in is OAuth 2.0 with S256 PKCE, which Gemini CLI documents for remote servers. The command above was checked against Gemini CLI 0.36.0 on 11 November 2026. We have not yet run a full sign-in from Gemini CLI against the live server ourselves, so tell us if a step differs for you.

No browser? Use an API key instead

Gemini CLI documents OAuth as needing a local browser, so on a headless machine or over SSH send a Blueticks bt_live_ API key as a bearer header instead. The command uses user scope so the key is stored in your home settings, not in a project folder that might be committed. Keep it out of shared shell history too.

gemini mcp add --scope user --transport http \
  --header "Authorization: Bearer bt_live_your_key_here" \
  blueticks https://api.blueticks.co/mcp

A first prompt: drafts only, nothing sent

Paste this into Gemini CLI. The last two sentences keep it to drafts, because the connector can send from your number. You read, edit and send each reply yourself.

Using Blueticks: list my one-to-one WhatsApp chats active in the last 7 days
where the last message is from the other person. Read the recent messages of
the top 10 in one batch. For each, write a short draft reply in my voice, with
the contact name above it. Do not send or schedule anything. I will send these
myself.

The server has twelve tools, checked 11 November 2026 against api.blueticks.co/mcp/info: see them on the MCP page. Approve each call yourself.

Gemini inside WhatsApp, and Gemini in the app

Google's Gemini apps availability page lists the Gemini web and mobile apps and does not mention WhatsApp. So a number you can message to reach Gemini is not something Google lists. If you want Gemini working on your own chats instead, the route is the one above. We have not verified that the Gemini app itself can add a custom MCP server, so this page does not claim it. For the wider picture, read Gemini on WhatsApp in 2026.

How it connects to WhatsApp

Blueticks operates an unofficial WhatsApp Web automation engine: your number is linked as a device. It is not the Meta Cloud API, and Blueticks is not affiliated with or endorsed by WhatsApp, Meta or Google. We cannot promise a number will never be restricted. If you message other people, consent and opt-out are your responsibility.

Frequently asked questions

Is there a Gemini number or bot inside WhatsApp?

Google's Gemini apps availability help page lists the Gemini web and mobile apps and does not mention WhatsApp, and Blueticks is not Google. What this page covers is the other direction: your own Gemini client working on your own WhatsApp chats.

How do I connect Gemini to WhatsApp?

Link your WhatsApp number in Blueticks. Then, in a terminal, run gemini mcp add --scope user --transport http blueticks https://api.blueticks.co/mcp, start Gemini CLI, run /mcp auth blueticks and sign in to Blueticks in the browser window it opens.

Does the Gemini app on the web or phone work?

We have not verified that the Gemini app can add a custom MCP server, so this page does not claim it. Gemini CLI documents remote MCP support, and that is the route described here.

Do I need an API key?

No. Gemini CLI documents OAuth for remote MCP servers: on a 401 it discovers the sign-in endpoints and runs the flow. Blueticks supports OAuth 2.0 with the authorization-code grant and S256 PKCE. If you would rather use a key, Gemini CLI also documents sending a bearer header, and Blueticks accepts a bt_live_ API key that way.

Does it work over SSH or in a headless terminal?

Gemini CLI's docs say OAuth for remote servers needs a local browser for the login redirect, so it will not work in most headless or SSH sessions. Use the API-key route there.

Does it use my own WhatsApp number?

Yes. You link your number as a WhatsApp Web linked device by QR code or phone-number link code. It is not the Meta Cloud API and not an official Meta product. If no WhatsApp is linked, or the connection is offline, requests fail with a "No WhatsApp is connected" error.

Can Gemini send messages, or only read?

The connector can read, send and schedule from your number. Approve each tool call yourself, and if you only want drafts, say so in the prompt as in the example above and send them yourself.

Which tools does Gemini see?

The server has twelve tools covering chats, contacts, groups, scheduled messages, audiences, campaigns, webhooks, tasks, engine and utilities. The full list is on the MCP page.

What does it cost?

There is no extra charge for the connector and it works on any Blueticks plan. The free plan allows 5 requests per 6 hours, shared with the API; paid plans have no request limit. See the pricing page for current prices.

Is there a ban risk?

Blueticks connects through the WhatsApp Web linked-device model. We cannot promise that WhatsApp will never restrict a number. Consent and opt-out for anyone you message are your responsibility.

Facts checked on 11 November 2026. More: hosted WhatsApp MCP service, connector for Claude, connector for ChatGPT, remote MCP server, pricing.