Peach MCP server
✓ VerifiedLets AI assistants send WhatsApp messages, manage templates, contacts, and media through the Peach messaging platform.
Also known as trypeach-io/mcp, @peachai/mcp
- Stars
- 0
- Tools
- 20
- Downloads, 30 days
- —
- Latest version
- 0.1.3
- Last commit
- Jun 3, 2026
- License
- MIT
What is Peach MCP?
Peach lets AI assistants send WhatsApp messages, manage templates, contacts, and media through the Peach messaging platform. It exposes 20 tools, such as peach_send_template_message, peach_send_app_message, peach_connect_to_ai_agent.
Summary generated from the project's README
About Peach MCP server
Sending WhatsApp messages and managing communication workflows through the Peach platform is what this MCP server enables for AI assistants. Developers can integrate these capabilities into clients like Claude Desktop, Cursor, or Claude Code by providing a Peach API key. The server supports both local installation via npx and a hosted configuration for easier setup.
Users can control various aspects of their messaging strategy, including sending template messages, launching broadcast campaigns, and managing contact lists. The toolset includes specific commands for media management such as uploading base64 files and deleting existing media. It also provides granular control over WhatsApp templates, allowing an assistant to create, update, submit for Meta review, or archive them as needed.
What you can do with it
- 1Handle template lifecyclesHave the assistant create new marketing templates or check the status of existing ones.
- 2Execute broadcast campaignsCommand the AI to start a large-scale broadcast using a specific template and audience.
Written from the project's README. Every use case is checked against a quote from it.
How to install Peach MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Peach MCP in Claude Code
$ claude mcp add mcp -- npx -y @peachai/mcpInstall Peach MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@peachai/mcp"
]
}
}
}Install Peach MCP in VS Code
.vscode/mcp.json
{
"servers": {
"mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@peachai/mcp"
]
}
}
}Install Peach MCP in VS Code CLI
$ code --add-mcp '{"name":"mcp","type":"stdio","command":"npx","args":["-y","@peachai/mcp"]}'Install Peach MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@peachai/mcp"
]
}
}
}Install Peach MCP in Codex
$ codex mcp add mcp -- npx -y @peachai/mcpInstall Peach MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.mcp] command = "npx" args = ["-y", "@peachai/mcp"]
Install Peach MCP in Gemini CLI
$ gemini mcp add -s user mcp npx -- -y @peachai/mcpInstall Peach MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@peachai/mcp"
]
}
}
}Peach MCP tools 20
Detected from the READMEpeach_send_template_messagepeach_send_app_messagepeach_connect_to_ai_agentpeach_get_event_statuspeach_list_template_messagespeach_launch_broadcastpeach_list_templatespeach_get_templatepeach_create_templatepeach_update_templatepeach_submit_templatepeach_pause_template
Show all 20 toolsShow fewer tools
peach_archive_templatepeach_create_contactpeach_create_contactspeach_update_contactpeach_list_mediapeach_upload_mediapeach_delete_mediapeach_list_messages
Configuration
PEACH_API_KEY
Automated checks
Ran Nov 14, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachabletrypeach-io/mcp is public and reachablegithub.com/trypeach-io/mcp ↗Pass
- Package names this repository as its source@peachai/mcp names trypeach-io/mcp as sourcenpmjs.com/package/@peachai/mcp ↗Pass
- Build provenance (Sigstore attestation)No build attestation published for this releaseNot checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-06-03github.com/trypeach-io/mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from @peachai/mcpPass
- No critical advisory in the package or its dependencies99 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model20 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNo tool named like delete, drop or execPass
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHub@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/mcp
Or 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 |
|---|---|
peach_send_template_message |
Send a WhatsApp template message to a contact |
peach_send_app_message |
Trigger a flow or app-initiated message |
peach_connect_to_ai_agent |
Send a template and connect the contact to an AI agent |
peach_get_event_status |
Check the status of a sent event |
peach_list_template_messages |
List sent template messages with filters |
Broadcasts
| Tool | Description |
|---|---|
peach_launch_broadcast |
Create and launch a broadcast campaign |
Templates
| Tool | Description |
|---|---|
peach_list_templates |
List all WhatsApp templates |
peach_get_template |
Get a specific template by ID or name |
peach_create_template |
Create a new WhatsApp template |
peach_update_template |
Update an existing template |
peach_submit_template |
Submit a template for Meta review |
peach_pause_template |
Pause an approved template |
peach_archive_template |
Archive a template |
Contacts
| Tool | Description |
|---|---|
peach_create_contact |
Create or upsert a single contact |
peach_create_contacts |
Bulk create or upsert contacts |
peach_update_contact |
Update a contact by phone number |
Media
| Tool | Description |
|---|---|
peach_list_media |
List uploaded media files |
peach_upload_media |
Upload a media file (base64) |
peach_delete_media |
Delete a media file |
Messages
| Tool | Description |
|---|---|
peach_list_messages |
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"
Peach MCP questions
How do I add Peach MCP to Claude Code?
Run claude mcp add mcp -- npx -y @peachai/mcp in your terminal. Add --scope user to make it available in every project.
How do I add Peach MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does Peach MCP provide?
It exposes 20 tools, including peach_send_template_message, peach_send_app_message, peach_connect_to_ai_agent, peach_get_event_status, peach_list_template_messages.
What are the system requirements for this server?
You need Node.js version 18 or higher and a Peach account with an API key.
Can I use this with Claude Desktop?
Yes, you can add the Peach configuration to your claude_desktop_config.json file.