Gallabox MCP Server

by navayuvan-gallabox

320 downloads Not rated yet

About

A Model Context Protocol (MCP) server implementation for Gallabox WhatsApp APIs. This server acts as a middleware between MCP clients and the Gallabox API, providing a standardized interface for sending WhatsApp messages.

Explore

- Send text messages via WhatsApp
- Send template messages with dynamic values
- Send interactive messages with reply buttons
- Provides confirmation with ID and status for each message
- Uses environment variables for API authentication

1. Clone the Repository:
Clone this repository to your local machine using:

   git clone https://github.com/yourusername/gallabox-mcp-server.git

2. Install Dependencies:
Navigate to the project directory and install the required dependencies:

   cd gallabox-mcp-server
yarn

To run the Gallabox MCP server with Claude Desktop, you need to configure the claude_desktop_config.json file. Below is a sample configuration:

{
  "mcpServers": {
    "whatsapp": {
      "command": "npx",
      "args": ["-y", "/Users/navayuvan/Works/gallabox-mcp-server"],
      "env": {
        "CHANNEL_ID": "<your_channel_id>",
        "GALLABOX_API_KEY": "<your_api_key>",
        "GALLABOX_API_SECRET": "<your_api_secret>"
      }
    }
  }
}

Restart Claude Desktop after adding this configuration.

- command: The command to run the server, using npx to execute the local package.
- args: Arguments passed to the command, specifying the path to your Gallabox MCP server.
- env: Environment variables required for the server to function, including your API credentials and channel ID.

recipient

(object): The recipient's details

name

(string): Recipient's name

phone

(string): Recipient's phone number

content

(string): The content of the text message

templateName

(string): The name of the template to use

templateValues

(object): Values to replace in the template

buttons

(array): Array of button objects for interaction

type

(string): Should be "reply"

reply

(object): Contains:

id

(string): ID of the reply button

title

(string): Title of the reply button

1. sendTextMessage
Send a text message via WhatsApp
Required inputs:
recipient (object): The recipient's details
name (string): Recipient's name
phone (string): Recipient's phone number
content (string): The content of the text message
Returns: Confirmation of message sent with ID and status.

2. sendTemplateMessage
Send a template message via WhatsApp
Required inputs:
recipient (object): The recipient's details
name (string): Recipient's name
phone (string): Recipient's phone number
templateName (string): The name of the template to use
templateValues (object): Values to replace in the template
Returns: Confirmation of template message sent with ID and status.

3. sendInteractiveMessage
Send an interactive message via WhatsApp
Required inputs:
recipient (object): The recipient's details
name (string): Recipient's name
phone (string): Recipient's phone number
content (string): The content of the interactive message
buttons (array): Array of button objects for interaction
Each button object must include:
type (string): Should be "reply"
reply (object): Contains:
id (string): ID of the reply button
title (string): Title of the reply button
Returns: Confirmation of interactive message sent with ID and status.

MCP Server for the Gallabox API, enabling interaction with WhatsApp messaging.

Tools

1. sendTextMessage
Send a text message via WhatsApp
Required inputs:
recipient (object): The recipient's details
name (string): Recipient's name
phone (string): Recipient's phone number
content (string): The content of the text message
Returns: Confirmation of message sent with ID and status.

2. sendTemplateMessage
Send a template message via WhatsApp
Required inputs:
recipient (object): The recipient's details
name (string): Recipient's name
phone (string): Recipient's phone number
templateName (string): The name of the template to use
templateValues (object): Values to replace in the template
Returns: Confirmation of template message sent with ID and status.

3. sendInteractiveMessage
Send an interactive message via WhatsApp
Required inputs:
recipient (object): The recipient's details
name (string): Recipient's name
phone (string): Recipient's phone number
content (string): The content of the interactive message
buttons (array): Array of button objects for interaction
Each button object must include:
type (string): Should be "reply"
reply (object): Contains:
id (string): ID of the reply button
title (string): Title of the reply button
Returns: Confirmation of interactive message sent with ID and status.

Setup

1. Clone the Repository:
Clone this repository to your local machine using:

   git clone https://github.com/yourusername/gallabox-mcp-server.git

2. Install Dependencies:
Navigate to the project directory and install the required dependencies:

   cd gallabox-mcp-server
yarn

Claude Desktop Configuration

To run the Gallabox MCP server with Claude Desktop, you need to configure the claude_desktop_config.json file. Below is a sample configuration:

{
  "mcpServers": {
    "whatsapp": {
      "command": "npx",
      "args": ["-y", "/Users/navayuvan/Works/gallabox-mcp-server"],
      "env": {
        "CHANNEL_ID": "<your_channel_id>",
        "GALLABOX_API_KEY": "<your_api_key>",
        "GALLABOX_API_SECRET": "<your_api_secret>"
      }
    }
  }
}

Restart Claude Desktop after adding this configuration.

Explanation of Configuration

- command: The command to run the server, using npx to execute the local package.
- args: Arguments passed to the command, specifying the path to your Gallabox MCP server.
- env: Environment variables required for the server to function, including your API credentials and channel ID.

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.