How to integrate Whatsapp MCP with Grok Build

Connect Grok Build to Whatsapp MCP. Send contact card to new lead, get business profile details for support, and more from your terminal, with authentication handled for you.

Get started for free Get a demo

Oauth2Api Key

WhatsApp is a business messaging platform for secure, automated customer communication. It streamlines chat workflows and customer outreach using the WhatsApp Business API.

58 Tools1 Triggers

Managed auth

Connect Whatsapp without auth hassles

We manage OAuth, API keys, token refresh, and scopes — you just build.

Book a call

Explore the MCP Gateway

How to integrate Whatsapp MCP with Grok Build

Grok Build is xAI's terminal coding agent. It runs on Grok 4.5, plans its work before it acts, and can run multiple sub-agents in parallel. It also reads Claude Code's MCP configuration, so any server you already have in a .mcp.json is picked up with no changes.

In this guide, I will show you how to connect your Whatsapp account to Grok Build through Composio, so it can send contact card to new lead, get business profile details for support, list all approved message templates, and more without leaving the terminal. Composio holds the OAuth tokens for you, and Grok Build only calls the tools you approve.

Why use Composio over a standalone MCP server?

Read and write access. Composio's Whatsapp integration lets Grok Build take real actions like creating drafts, sending updates, and labeling records, not just reading data.
1,500+ SaaS toolkits out of the box. One endpoint gives you a full catalog of pre-built connectors, from Gmail and Slack to Notion, Linear, and Salesforce.
One MCP server for every app. Wire up a single Composio server instead of maintaining a separate MCP entry for each app.
Smart, context-aware tool loading. Grok Build caps how many tools it holds in a single request. Composio loads only the tools a task needs, so you do not spend that budget on tools you are not using.
Cross-app automation. Chain actions across apps in one run. Pull a thread, summarize it in Notion, and post the highlights to Slack from a single prompt.

Prerequisites

Grok Build installed and signed in. Install with curl -fsSL https://x.ai/cli/install.sh | bash on macOS or Linux, or irm https://x.ai/cli/install.ps1 | iex on Windows PowerShell. On first launch Grok opens a browser to authenticate; for headless or CI use, set an XAI_API_KEY environment variable instead (create the key at console.x.ai).
Access to the Whatsapp account you want to connect.
The Composio MCP endpoint. Composio's server is remote and hosted, so there is nothing to run locally and no tunnel to set up.

Step-by-step: Connect Whatsapp to Grok Build

1. Install and verify Grok Build

Install the CLI, then restart your shell so the grok binary lands on your PATH:

bash

curl -fsSL https://x.ai/cli/install.sh | bash
which grok

On Windows, install with PowerShell instead: irm https://x.ai/cli/install.ps1 | iex. If which grok returns a path, you are set. Grok Build runs on Grok 4.5 by default; you can switch models inside the session with /model <name>.

2. Add the Composio server

Add Composio as a remote HTTP MCP server with the grok mcp add command:

bash

grok mcp add --transport http composio https://connect.composio.dev/mcp

You can also add and manage servers from inside a session. Run /mcps to open the extensions modal on the MCP tab, then add a new server and paste the Composio URL. Added this way, Grok auto-detects the name from the URL and lists the server as connect:

bash

https://connect.composio.dev/mcp

Grok Build /mcps extensions modal listing MCP servers

Grok Build adding the Composio MCP server with its URL

Grok also reads Claude Code-style config, so an entry in ~/.grok/config.toml or a project .mcp.json works the same way.

3. Authenticate

Composio uses OAuth. In the /mcps modal, select the Composio server and press i to authenticate (Grok also triggers this browser flow automatically the first time it uses a Composio tool). Click Allow to authorize access. Grok stores the tokens under ~/.grok/mcp_credentials.json, and /mcps shows Composio as connected.

Grok Build prompting to authenticate the Composio MCP server

Composio authorization screen with the Allow button for Grok Build

4. Start building

Ask Grok to work with your Whatsapp account through Composio. On the first Whatsapp action, Composio prompts you to connect the account through OAuth. Approve the scopes once, and Composio handles token refresh from there.

What you can do after connecting Whatsapp

Send contact card to new lead
Get business profile details for support
List all approved message templates
Download media from latest customer message

Security + privacy notes (important)

Use least-privilege access. Grant only the Whatsapp scopes you actually need.
Review OAuth scopes before approving. Check that the requested scopes match what you expect Composio and Grok Build to do.
Keep write actions human-reviewed. Grok Build proposes a plan before it acts. Leave that approval step on for actions like sending messages or editing records.
Keep secrets out of version control. Your XAI_API_KEY and any tokens should never be committed. Use environment variables or a secrets manager.

TOOLS & TRIGGERS

Supported Tools and Triggers

Every Whatsapp action and event your agent gets out of the box.

Block WhatsApp Users

Block one or more WhatsApp users to prevent them from sending messages to your business phone number.

Configure WhatsApp Conversational Automation

Configure conversational automation settings for a WhatsApp Business phone number.

Create WhatsApp Flow

Create a new WhatsApp Flow for the WhatsApp Business Account.

Create WhatsApp Max Price Agreement

Create a max price agreement for WhatsApp marketing messages pricing.

Create message template

Create a new message template for the WhatsApp Business Account.

Create QR Code

Create a new QR code with a prefilled message for a WhatsApp Business phone number.

Create upload session for WhatsApp

Create a resumable upload session for large file uploads to WhatsApp.

Delete WhatsApp Media

Delete a WhatsApp media file previously uploaded via the Media API.

Delete message template

Delete a message template from the WhatsApp Business Account by name.

Delete QR Code

Delete a specific QR code from a WhatsApp Business phone number.

Deregister WhatsApp Business Phone Number

Deregister a WhatsApp Business phone number from the Cloud API.

Get WhatsApp Business Account Activities

Retrieve activity history for a WhatsApp Business Account.

Get WhatsApp Business Account Details

Retrieve comprehensive details about a WhatsApp Business Account (WABA).

Get WhatsApp Business Compliance Info

Retrieve comprehensive business compliance information for a WhatsApp Business phone number.

Get Business Encryption

Retrieve the WhatsApp Business public key and its signature verification status.

Get business profile

Get the business profile information for a WhatsApp Business phone number.

Get client WhatsApp Business Accounts

Retrieve WhatsApp Business Accounts shared with or managed by a business portfolio.

Get WhatsApp Commerce Settings

Get commerce settings for a WhatsApp Business phone number.

Get Flow Assets

List assets associated with a WhatsApp Flow.

Get Join Requests

Get all pending join requests for a WhatsApp group.

Get media info

Get metadata and download URL for uploaded WhatsApp media.

Get WhatsApp Message History

Retrieve message history for a WhatsApp Business phone number.

Get message templates

Get all message templates for the WhatsApp Business Account.

Get owned WhatsApp Business Accounts

Retrieve WhatsApp Business Accounts owned by a business portfolio.

Get phone number

Retrieve detailed information about a specific WhatsApp Business phone number.

Get phone numbers

Retrieve all phone numbers registered to your WhatsApp Business Account.

Get WhatsApp Schedules

Retrieve campaign schedules associated with a WhatsApp Business Account.

Get WhatsApp Cloud API Settings

Get Cloud API settings for a WhatsApp Business phone number.

Get Subscribed Apps

Get all applications currently subscribed to webhooks for a WhatsApp Business Account.

Get message template library

Browse the pre-built message template library for WhatsApp Business Account.

Get template status

Get the status and details of a specific message template.

List WhatsApp Flows

List all WhatsApp Flows associated with the WhatsApp Business Account.

List WhatsApp Groups

List all WhatsApp groups associated with a business phone number.

List qr codes

Get a list of all QR codes for a WhatsApp Business phone number.

List WhatsApp Solutions

Retrieve a paginated list of Multi-Partner Solutions for a WhatsApp Business Account.

Publish WhatsApp Flow

Publish a WhatsApp Flow to make it available for use.

Remove Assigned User from WhatsApp Business Account

Remove a user's access from the WhatsApp Business Account.

Send contacts

Send contacts WhatsApp number.

Send interactive buttons

Send an interactive button message with up to 3 reply buttons to a WhatsApp user.

Send interactive list

Send an interactive list message to a WhatsApp number.

Send location

Send a location message with coordinates, name, and address to a WhatsApp user.

Send media

Send a media message to a WhatsApp number.

Send media by

Send media using a media ID from previously uploaded media.

Send message

Send a text message to a WhatsApp user.

Send template message

Send a template message to a WhatsApp number.

Set WhatsApp Two-Step Verification PIN

Set or reset the two-step verification PIN for a WhatsApp Business phone number.

Subscribe to WABA Webhooks

Subscribe your application to receive webhook notifications for a WhatsApp Business Account (WABA).

Unsubscribe from WABA Webhooks

Unsubscribe your application from webhook events for a WhatsApp Business Account (WABA).

Update WhatsApp Flow Metadata

Update metadata for a WhatsApp Flow including its name, categories, and endpoint URI.

Update WhatsApp Business Profile

Update WhatsApp Business Profile information including business details, contact information, and profile settings.

Update WhatsApp commerce settings

Set or update commerce settings for a WhatsApp Business phone number.

Update Flow JSON

Update the Flow JSON configuration for a WhatsApp Flow.

Update WhatsApp Cloud API Settings

Update Cloud API settings for a WhatsApp Business phone number.

Upload media

Upload media files (images, videos, audio, documents, stickers) to WhatsApp servers.

Upsert message template

Create or update a message template for the WhatsApp Business Account.

Verify Phone Number OTP Code

Verify the OTP code for a pre-verified phone number.

Who Am I

Return the identity (name) of the connected WhatsApp (Meta) account.

FRAMEWORKS

How to build Whatsapp MCP Agent with another framework

Claude Code

Use Whatsapp MCP with Claude Code

Cursor

Use Whatsapp MCP with Cursor

ChatGPT

Use Whatsapp MCP with ChatGPT

Claude Cowork

Use Whatsapp MCP with Claude Cowork

Antigravity

Use Whatsapp MCP with Antigravity

OpenAI Agents SDK

Use Whatsapp MCP with OpenAI Agents SDK

Claude Agent SDK

Use Whatsapp MCP with Claude Agent SDK

Grok Bot

Use Whatsapp MCP with Grok Bot

Muse

Use Whatsapp MCP with Muse

Codex

Use Whatsapp MCP with Codex

Kimi Code

Use Whatsapp MCP with Kimi Code

VS Code

Use Whatsapp MCP with VS Code

OpenCode

Use Whatsapp MCP with OpenCode

OpenClaw

Use Whatsapp MCP with OpenClaw

Hermes

Use Whatsapp MCP with Hermes

Atomic Agent

Use Whatsapp MCP with Atomic Agent

Pi

Use Whatsapp MCP with Pi

DeepSeek Harness

Use Whatsapp MCP with DeepSeek Harness

CLI

Use Whatsapp MCP with CLI

Google ADK

Use Whatsapp MCP with Google ADK

LangChain

Use Whatsapp MCP with LangChain

Vercel AI SDK

Use Whatsapp MCP with Vercel AI SDK

Mastra AI

Use Whatsapp MCP with Mastra AI

LlamaIndex

Use Whatsapp MCP with LlamaIndex

CrewAI

Use Whatsapp MCP with CrewAI

Pydantic AI

Use Whatsapp MCP with Pydantic AI

AutoGen

Use Whatsapp MCP with AutoGen

MORE TOOLKITS

Explore Other Toolkits

Toolkit marketplace

Gmail

Oauth2

Gmail is Google's email service with powerful spam protection, search, and G Suite integration. It keeps your inbox organized and makes communication fast and reliable.

Outlook

Oauth2S2s Oauth2

Outlook is Microsoft's email and calendaring platform for unified communications and scheduling. It helps users stay organized with powerful email, contacts, and calendar management.

Slack

Oauth2

Slack is a channel-based messaging platform for teams and organizations. It helps people collaborate in real time, share files, and connect all their tools in one place.

Gong

BasicOauth2

Gong is a platform for video meetings, call recording, and team collaboration. It helps teams capture conversations, analyze calls, and turn insights into action.

FAQ

Frequently asked questions

A standalone Whatsapp MCP server gives Grok Build a fixed set of Whatsapp tools tied to that one server. The Composio Tool Router lets Grok Build load tools from Whatsapp and many other apps on demand, based on the task, all through a single endpoint.

Yes. Grok Build ships with native MCP support. Add a server with the grok mcp add command, from the in-session /mcps modal, or by editing ~/.grok/config.toml. It also reads Claude Code-style .mcp.json files, so Grok Build discovers the tools automatically.

Yes. Grok Build has zero-migration compatibility with Claude Code's configuration, so the same Composio server entry works in both without edits.

Tokens, keys, and configuration are encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant, so your Whatsapp data and credentials are handled to that standard.

Start with Whatsapp.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Whatsapp tool your agent needs.Free to start.

Start building

How to integrate Whatsapp MCP with Grok Build

Connect Whatsapp without auth hassles

How to integrate Whatsapp MCP with Grok Build

Also integrate Whatsapp with

Why use Composio over a standalone MCP server?

Prerequisites

Step-by-step: Connect Whatsapp to Grok Build

1. Install and verify Grok Build

2. Add the Composio server

3. Authenticate

4. Start building

What you can do after connecting Whatsapp

Security + privacy notes (important)

Supported Tools and Triggers

How to build Whatsapp MCP Agent with another framework

Claude Code

Cursor

ChatGPT

Claude Cowork

Antigravity

OpenAI Agents SDK

Claude Agent SDK

Grok Bot

Muse

Codex

Kimi Code

VS Code

OpenCode

OpenClaw

Hermes

Atomic Agent

Pi

DeepSeek Harness

CLI

Google ADK

LangChain

Vercel AI SDK

Mastra AI

LlamaIndex

CrewAI

Pydantic AI

AutoGen

Explore Other Toolkits

Gmail

Outlook

Slack

Gong

Frequently asked questions

What is the difference between the Composio Tool Router and a standalone Whatsapp MCP server?+

Does Grok Build support MCP?+

Can I reuse the same MCP config I already use with Claude Code?+

How safe is my Whatsapp data with Composio?+

Start with Whatsapp.It takes 30 seconds.