Clicksend MCP Server

What clicksend-mcp-server MCP server does

The clicksend-mcp-server MCP server exposes selected ClickSend messaging operations to an MCP-compatible AI client. Its main use is SMS automation: an agent can send a message to a phone number, send to contacts associated with a contact list, check estimated pricing, and inspect existing messaging data.

The implementation is the official server from the ClickSend team. It is intended for developers who want an AI interface to ClickSend rather than building a separate application around the ClickSend REST API. The available functionality is focused on SMS and related account data, not general ClickSend services.

How it works

The server uses ClickSend credentials supplied through environment variables and calls ClickSend’s supported endpoints on the agent’s behalf. The send operation accepts recipients as phone numbers or contacts from a contact list. Phone numbers must use E.164 formatting, such as +61411111111.

The server can also request SMS templates, retrieve sent-message history with filtering and pagination, calculate message pricing based on message type and length, and return SMS statistics for the previous 30 days. Contact-list searches provide lists that can be used when addressing messages to stored contacts.

Setup and configuration

Node.js 18 or newer is required. Node Version Manager can be used to select a compatible Node.js version. You need a ClickSend username and API key, available from the ClickSend account dashboard after signing up.

For Claude Desktop, add an MCP server entry that runs the published package with npx, or point a node command at a locally built build/clicksend-mcp.js file. Supply these environment variables in the client configuration:

• CLICKSEND_USERNAME
• CLICKSEND_API_KEY

Restart Claude Desktop after changing its configuration. A successful connection exposes the SMS tool in the client’s tool interface. Keep both credentials out of source control and avoid including them in issue reports or pull requests.

Tools and capabilities

The documented operations are:

• send-sms: Send an SMS to phone numbers or contacts from a contact list.
• calculate-sms-price: Estimate the cost of sending messages from message type and length.
• view-sms-templates: Retrieve SMS templates with filtering options.
• view-sms-history: Retrieve previously sent messages with filtering and pagination.
• view-sms-statistics: Get SMS statistics for the last 30 days.
• view-contact-lists: Search and return contact lists.

Together, these tools support basic message delivery, preparation, and review workflows through natural-language requests.

Limitations and notes

ClickSend account rate limits and pricing apply to requests made through the server. Invalid credentials prevent authentication; verify the username and API key in the ClickSend dashboard if this occurs. A phone-number format error generally means the number is missing the plus sign or country code.

The documentation describes SMS operations only. It does not establish support for other ClickSend communication channels or additional account-management APIs. The server also does not remove the need to handle recipient data and credentials securely in the surrounding client or workflow.