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

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"