@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

Broadcasts

Templates

Contacts

Media

Messages

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"