@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

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"
      }
    }
  }
}

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"