Peach Server

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

If you're setting this up in Claude, use this:

{
  "mcpServers": {
    "peach": {
      "command": "node",
      "args": [
        "<path_to_node_version>/node_modules/mcp-remote/dist/proxy.js",
        "https://app.trypeach.ai/api/mcp",
        "--header",
        "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"
      }
    }
  }
}

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"