What is Clicksend Mcp Server

clicksend-mcp-server is a Model Context Protocol (MCP) server designed for messaging, enabling AI assistants like Claude to send SMS and MMS messages using the ClickSend service.

Use cases

Use cases include sending promotional SMS to customers, notifying users about updates or events, and facilitating communication between AI assistants and users.

How to use

To use clicksend-mcp-server, configure your ClickSend username and API key in the server’s environment variables. Then, integrate it with Claude Desktop by adding the necessary configuration in the specified JSON file and restart Claude Desktop.

Key features

Key features include the ability to send one SMS at a time, requiring only a ClickSend username and API key for configuration.

Where to use

clicksend-mcp-server can be used in various fields where messaging is required, such as customer support, notifications, marketing campaigns, and personal communication.

ClickSend MCP Server

A Model Context Protocol (MCP) server that enables Claude and other AI assistants to send SMS and MMS messages using ClickSend.

Features

• Send one SMS at a time by setting up the clicksend username and API Key

Requirements

• Node.js >= 18
  • you can usenvm (Node Version Manager) to set the right version to run this app

Configuration

The server requires two environment variables:

• CLICKSEND_USERNAME: Your ClickSend username
• CLICKSEND_API_KEY: Your ClickSend API Key

You can find the username and key at https://dashboard.clicksend.com/account/subaccounts once you Sign Up to ClickSend

Claude Desktop Configuration

To use this server with Claude Desktop, add the following to your configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: %APPDATA%\Claude\claude_desktop_config.json

After that, restart Claude Desktop to reload the configuration.
If connected, you should see clicksend-send-sms when you click on the hammer icon

Example Interactions with Claude

Here are some natural ways to interact with the server through Claude:

Simple SMS:

Send a text message to the number 61411111111 saying "I'm using ClickSend MCP server to sent SMS!"

Important Notes

1. Phone Number Format: All phone numbers must be in E.164 format (e.g., +61411111111)
2. Rate Limits: Be aware of your ClickSend account’s rate limits and pricing
3. Security: Keep your ClickSend credentials secure and never commit them to version control

Troubleshooting

Common error messages and solutions:

1. “Phone number must be in E.164 format”

   • Make sure the phone number starts with “+” and the country code

2. “Invalid credentials”

   • Double-check your CLICKSEND_USERNAME and CLICKSEND_API_KEY. You can copy them from the ClickSend Dashboard

Contributing

Contributions are welcome! Please read our contributing guidelines before submitting pull requests.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Security

Please do not include any sensitive information (like phone numbers or ClickSend credentials) in GitHub issues or pull requests.