Features

Integrations

Case Studies

Resources

How to Set Up a WhatsApp MCP Server in 2025: A Complete Step-by-Step Guide

How to Set Up a WhatsApp MCP Server in 2025: A Complete Step-by-Step Guide

Swapnika Nag

|

Apr 11, 2025

Brought to you by Periskope

Brought to you by Periskope

Manage your WhatsApp groups, chats & numbers at scale

Manage your WhatsApp groups, chats & numbers at scale

Set up your own WhatsApp MCP Server in minutes — unlock AI-powered messaging, automation, and smart workflows in 2025.

If you've ever wanted to connect an AI assistant (like Claude or ChatGPT) to your WhatsApp messages — to help summarize conversations, send smart replies, or build your own assistant — you’ve probably realized there’s no simple way to do it.

WhatsApp’s official API is limited, expensive, does not connect with regular WhatsApp numbers. But in 2025, the best way to unlock real control over WhatsApp is with a WhatsApp MCP Server.

This guide shows you exactly how to set one up using Periskope — and the best part? It’s fully hosted.

What Is a WhatsApp MCP Server?

A WhatsApp MCP Server acts as a secure, AI-friendly gateway between your WhatsApp account and your assistant (like Claude or GPT). It uses a protocol called MCP (Model Context Protocol) — which is just a fancy way of saying: "Here’s a standard way for AI models to understand and work with external tools."

With MCP, your assistant can:
- Access your WhatsApp messages and chats
- Reply intelligently
- Search, summarize, and organize conversations
- Connect your WhatsApp with other tools in your ecosystem (like email, calendar and more)

What You'll Need

Before we get into the setup, here’s what you’ll need:
- A WhatsApp account (on your phone)
- A Periskope account
- An AI assistant that supports MCP (like Claude Desktop or Cursor)

That’s it.

Step-by-Step: Set Up Your WhatsApp MCP Server

Setting up a WhatsApp MCP Server today is a lot easier than it sounds — and if you're using Periskope, it's basically plug-and-play.

Here’s the basic flow:

1. Link your WhatsApp account

  • Go to console.periskope.app and log in.

  • Add a phone by scanning the QR code using the “Link a Device” feature in your WhatsApp app.

  • Once linked, Periskope will auto create a WhatsApp MCP server for your connected number

2. Get your MCP API key

  • In the Periskope console, head to Settings → MCP.

  • Create a new API key — this will be used to authorize your assistant.

3. Install the WhatsApp MCP package

In your terminal:

4. Update your MCP config

If you're using something like Cursor or Claude Desktop, you’ll want to edit your MCP config file (typically at ~/.cursor/mcp.json) and add:

jsonCopyEdit{
  "mcpServers": {
    "periskope-mcp": {
      "command": "npx",
      "args": ["-y", "@periskope/whatsapp-mcp"]

That’s it — your Claude or GPT assistant can now talk to your actual WhatsApp account.

You can also follow the steps in this video to setup your MCP server:

Why Developers and Power Users Love This

This setup is a game-changer for:
- Indie builders who want to build smart tools on top of WhatsApp
- Founders running customer support directly from WhatsApp
- Power users who want an AI assistant to handle routine messaging
- Anyone who’s tired of half-baked WhatsApp bots and wants real AI access

With this flow, you’re not dealing with unreliable bots. You're giving your assistant real access to your real conversations, in a clean, private, and structured way.

Whether you’re building the next AI support agent or just want Claude to reply to your WhatsApp groups, this setup is the fastest and most developer-friendly way to do it in 2025.

2000+ customers use Periskope to

Connect multiple WhatsApp numbers

Manage WhatsApp groups & chats

Create tickets and tasks

Manage team access

Automate workflows

…and more

Automate your WhatsApp with Periskope

Automate your WhatsApp with Periskope

Automate your WhatsApp with Periskope