send-sms
Send SMS messages through the Aligo API
LABSCO SUMMARY
One tool, but its parameters reach past an immediate send: a message type, an image and a scheduled time.
The interesting arguments here are the ones that are not the message text. msg_type distinguishes the kind of message being sent, image_path attaches an image, and schedule_date with schedule_time defers delivery, so a reminder or a timed campaign does not need a scheduler of your own wrapped around the call. Sender and receiver are per-call parameters rather than server configuration, which means one server can send on behalf of different numbers — and equally that nothing in the tool set constrains which number it sends as.
What it is
A single-tool SMS sender for the Aligo API.
What you get
- One call carrying more than the text: send-sms takes the sender and receiver, the message with a title and a msg_type, an image_path, a destination, and a schedule_date with a schedule_time for sending later.
Requirements
An Aligo account that can send from the sender number you pass. Its API key and user id go in a .garakrc file in your home directory, which is where the server reads them — not the client config. The sender and receiver are supplied per call.
Setup effort
One command plus a key — npx -y github:hongsw/aligo-sms-mcp-server mcp-server, then supply credentials
USE CASES
01
Sending a message from inside a workflow
Send the text from the sender number to the recipient, attaching an image where the message needs one.
02
Scheduling a reminder to go out later
Set the scheduled date and time on the send so the message leaves at the right moment without a scheduler of your own.
1 tool
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
BEFORE YOU INSTALL
What to know first
Tools you get
1 tool when we connected.
Requires
- npx on PATH
- ALIGO_API_KEY and ALIGO_USER_ID in ~/.garakrc
Where it runs
The documented client runs the server on your machine.
CONTEXT COST
Light Standing cost
Rated by the size of the one tool definition that rides along on every turn
INSTALLATION
Connect your client
Server setup
TERMINAL
npx -y github:hongsw/aligo-sms-mcp-server mcp-serverMCP Clients
Claude Desktop — npx
CLAUDE DESKTOP — NPX · JSON
{
"mcpServers": {
"aligo-sms-mcp": {
"command": "npx",
"args": [
"-y",
"github:hongsw/aligo-sms-mcp-server",
"mcp-server"
]
}
}
}The server reads ALIGO_API_KEY, ALIGO_USER_ID and ALIGO_TEST_MODE from a .garakrc file in your home directory, not from this configuration. The key and user id are issued at https://smartsms.aligo.in/admin/api/auth.html; with ALIGO_TEST_MODE=Y nothing is delivered — set it to N to send.
