
Swapnika Nag
|
Apr 11, 2025
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:
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.