Peach MCP Server
The Peach MCP Server enables AI assistants to manage WhatsApp messaging, templates, contacts, and media through the Peach platform.
Messaging
Send template messages to contacts
Trigger flows or app-initiated messages with optional fallback templates
Connect contacts to AI agents via automated routing
Check event status (delivered, read, failed)
List sent template messages with filters (date range, status, phone number, template name)
Broadcasts
Launch broadcast campaigns to multiple contacts or audience lists, with instant/smart delivery and scheduling options
Templates
List, retrieve, create, update, submit for Meta review, pause, and archive WhatsApp templates
Supports MARKETING, UTILITY, and AUTHENTICATION categories with header, body, footer, and button components
Contacts
Create or upsert single/bulk contacts with name, email, phone, timezone, and custom metadata
Update contacts by phone number (opt-out status, language, nickname, etc.)
Media
List, upload (base64-encoded), and delete media files
Messages
List messages with filters for date range, direction (inbound/outbound), phone number, and pagination
Enables interaction with the Peach WhatsApp messaging platform to send messages, manage templates and contacts, handle media, and launch broadcast campaigns.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Peach MCP ServerSend the welcome template to +14155550123"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
@peachai/mcp
MCP (Model Context Protocol) server for the Peach WhatsApp messaging platform. Lets AI assistants like Claude send messages, manage templates, contacts, and media directly through your Peach account.
Requirements
Node.js 18 or higher
A Peach account with an API key
Getting your API key
Log in to app.trypeach.ai, go to Settings → API, and copy your API key.
Setup
Hosted Server setup
Recommended Peach offers hosted MCP server. We recommend using this.
{
"mcpServers": {
"peach": {
"url": "https://app.trypeach.ai/api/mcp",
"headers": {
"Authorization": "<YOUR PEACH API KEY>"
}
}
}
}Claude Desktop
Add the following to your claude_desktop_config.json:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"peach": {
"command": "npx",
"args": ["-y", "@peachai/mcp"],
"env": {
"PEACH_API_KEY": "your-api-key"
}
}
}
}Restart Claude Desktop. You should see the Peach tools available in your conversation.
Cursor
Go to Settings → MCP and add:
{
"peach": {
"command": "npx",
"args": ["-y", "@peachai/mcp"],
"env": {
"PEACH_API_KEY": "your-api-key"
}
}
}Claude Code
Run this command to add Peach AI to your Claude Code setup:
claude mcp add --scope user --env PEACH_API_KEY=your-api-key peach -- npx -y @peachai/mcpOr add it manually to your .mcp.json:
{
"mcpServers": {
"peach": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@peachai/mcp"],
"env": {
"PEACH_API_KEY": "your-api-key"
}
}
}
}Antigravity
Go to Antigravity settings -> Customizations. Click Open MCP Config and add the following:
{
"mcpServers": {
"peach": {
"serverUrl": "https://app.trypeach.ai/api/mcp",
"headers": {
"Authorization": "<YOUR PEACH API KEY>"
}
}
}
}Available tools
Messaging
Tool | Description |
| Send a WhatsApp template message to a contact |
| Trigger a flow or app-initiated message |
| Send a template and connect the contact to an AI agent |
| Check the status of a sent event |
| List sent template messages with filters |
Broadcasts
Tool | Description |
| Create and launch a broadcast campaign |
Templates
Tool | Description |
| List all WhatsApp templates |
| Get a specific template by ID or name |
| Create a new WhatsApp template |
| Update an existing template |
| Submit a template for Meta review |
| Pause an approved template |
| Archive a template |
Contacts
Tool | Description |
| Create or upsert a single contact |
| Bulk create or upsert contacts |
| Update a contact by phone number |
Media
Tool | Description |
| List uploaded media files |
| Upload a media file (base64) |
| Delete a media file |
Messages
Tool | Description |
| List messages with optional filters |
Example prompts
"Send the order_confirmation template to +14155552671 with order ID 12345"
"Create a new MARKETING template called summer_sale with a body saying 'Get 20% off this weekend!'"
"List all my approved WhatsApp templates"
"Update the contact +14155552671's name to John Smith"
"Launch a broadcast using template promo_v2 to audience list abc123"
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/trypeach-io/mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server