Grok + WhatsApp via the Blueticks MCP Server
Grok takes custom MCP servers. Add Blueticks and Grok can read your WhatsApp chats and send messages from your own number. The setup, what it can touch, and how to cut it off.
Daniel Roth7 min read

On this page
Grok can connect to outside tools through MCP, the open standard for giving an AI assistant tools. The Blueticks MCP server is one such tool: it lets an assistant read your WhatsApp chats and send messages from your own number.
We connected the two ourselves. Our founder's word for the experience was "seamless". That is one person's report, so this guide sticks to what the docs and our server confirm: the setup, what Grok gets, what keeps it running with your computer off, and how to cut it off.
How do you connect Grok to Blueticks over MCP?
You add Blueticks as a custom connector on grok.com and sign in once. xAI documents the connector steps in its Connectors guide.
- Have a WhatsApp engine ready in Blueticks. The MCP server sends through the engine on your account. See the always-on section below.
- Open grok.com/connectors. Click New Connector, then select Custom.
- Enter the server URL. It is
https://api.blueticks.co/mcp. xAI says the server must be reachable over the public internet, which ours is. - Complete the sign-in. xAI's docs say to complete any required authentication. In our own test, Grok sent us to a Blueticks login page to approve access. Our server supports OAuth 2.0 with the authorization-code flow and S256 PKCE, plus dynamic client registration, so you do not need to paste an API key.
- Test it. Ask Grok to list your latest WhatsApp chats.
xAI's docs say Grok discovers the tools a custom server exposes and makes them available in conversations. On Grok Business and Enterprise, xAI says a team admin must first add the connector in the cloud console before members can connect.
What tools does Grok get?
Grok is not a named client in our server, so it receives the default tool set that every non-ChatGPT client gets. The public catalog lists twelve tools:
| Tool | What it does | Read-only? |
|---|---|---|
chats_read | Chat lookup, message history, media, poll results, participants | Yes |
chats_write | Send messages immediately; mark read, react, archive, load older history | No |
scheduled_messages_read | List queued messages and check delivery and read status | Yes |
scheduled_messages_write | Send or schedule messages, edit ones not yet sent, cancel them | No |
contacts | List contacts known to your engine, get a profile picture | Yes |
groups | Read, create and manage WhatsApp groups | No |
audiences | Reusable contact lists used as campaign recipients | No |
campaigns | Paced bulk sends to an audience, with pause, resume and cancel | No |
webhooks | URLs that receive a POST when Blueticks events occur | No |
tasks | Tasks on your own Blueticks boards | No |
engine | Engine status, and controls such as logout | No |
utils | Check a phone number is on WhatsApp, link previews | Yes |
The OAuth server defines mcp:read and mcp:write scopes. Whether Grok lets you approve only read access is up to Grok, so check the consent screen.
Can you use Grok's API instead of the connectors page?
Yes. xAI's Remote MCP Tools guide shows how to add an MCP server to a request through the tools array. Only the Streamable HTTP and SSE transports are supported, and the Blueticks server is a remote HTTP server.
The docs list server_url and server_label as required, and an optional authorization field whose token is set in the Authorization header on requests to the server. For Blueticks, that token is a bt_live_ key from Blueticks API, created with only the scopes you need.
One setting matters for safety. xAI says that if you leave allowed_tools empty, every tool the server exposes is injected into the model's context. To keep Grok read-only, list only the read tools, for example chats_read, scheduled_messages_read, contacts and utils. The xAI native SDK calls this parameter allowed_tool_names.
Why does an always-on connection need a Gateway?
Because Blueticks sends through your own WhatsApp session, and that session has to be running somewhere. There are two options:
| Where your WhatsApp session runs | When Grok can send |
|---|---|
The Blueticks browser extension with web.whatsapp.com open in Chrome | Only while your computer is on and the browser is open |
| A Blueticks Gateway, the cloud-hosted engine (Pro plan) | Always, including with your computer off |
If you want Grok to answer a request at 3 a.m. or send a scheduled message while your laptop is closed, add a Gateway at app.blueticks.co/connections. You link your number by scanning the QR code or choosing "Link with phone number", which gives you a code to type into WhatsApp on your phone. For what runs where, see how a WhatsApp AI agent answers with your computer off.
Messages go out as you, from your own number, as linked-device sessions. That is not Meta's Cloud API, and no setup removes the risk of WhatsApp restricting a number, so message people who expect to hear from you.
How do you keep an assistant with WhatsApp access safe?
Several Blueticks tools act immediately, so set the rules before you let Grok use them:
chats_writesends right away. To keep a message editable or cancellable first, schedule it withscheduled_messages_writeinstead.campaignsstarts a paced bulk send to every contact in the audience. Campaigns have pause, resume and cancel controls, but tell Grok to confirm the audience, text and timing with you before it creates one.enginecan sign your engine out of WhatsApp, and linking the number again takes a new pairing. Tell Grok to use it only when you ask.- Review what it did. Check scheduled messages in your Blueticks calendar and recent chats on your phone after any session where it had send access.
To cut Grok off, from lightest to firmest:
- Remove the connector in Grok. xAI does not document removal for personal accounts, so look for a remove option on the connector at grok.com/connectors. On Grok Business and Enterprise, xAI says a team admin can remove it in the cloud console. Confirm Blueticks no longer works in Grok afterwards.
- Revoke the key, if you used a
bt_live_key through the API. Revoke it under Blueticks API, and it stops working. - Remove the device from WhatsApp. In WhatsApp on your phone, open Linked Devices and remove the Blueticks device.
FAQ
Does Grok have an official Blueticks integration?
No. Blueticks has no Grok-specific setup, and it is not one of the built-in connectors xAI documents. Grok connects as an ordinary remote MCP client through a custom connector.
Do I need a Gateway to connect Grok?
No. The MCP connection works with the extension too, but Grok can only send while your computer is on and WhatsApp Web is open. A Gateway keeps it running with your computer off.
Will Grok read all my WhatsApp chats?
It can read the chats chats_read can reach once you approve the connection, so decide whether you want that before you approve.
Which Blueticks plan do I need?
The connector has no extra charge and works on any plan. The free plan allows 5 requests per 6 hours, shared with the API, and paid plans have no request limit, per the MCP page. Always-on sending needs the Pro plan with a Gateway. Which Grok plan you need is set by xAI, so check its Connectors guide.
