Kudosity SMS Plugin for Claude Code
Send SMS, MMS, manage contact lists, and configure webhooks using the Kudosity messaging platform — directly from Claude Code.
Overview
This plugin integrates Claude Code with the Kudosity messaging APIs, enabling you to send SMS and MMS messages, create and manage contact lists, and configure webhooks through natural language commands.
All API operations are executed locally on your machine by Claude Code using curl with your own API credentials. The plugin connects to a remote MCP server for API documentation lookup only — no message data or credentials are sent through it.
Features
| Skill | Description |
|---|
/kudosity-sms:send-sms | Send SMS to individuals or contact lists (V1 + V2 API) |
/kudosity-sms:send-mms | Send multimedia messages with images, GIFs, video, or audio (V2 API) |
/kudosity-sms:create-list | Create contact lists and add recipients (V1 API) |
/kudosity-sms:setup-webhook | Configure delivery status notifications, inbound messages, and more (V2 API) |
The plugin also includes:
/kudosity-sms:setup — interactive credential configuration and verification commandkudosity-assistant — a specialized agent for coordinating multi-step messaging operations
Prerequisites
- Kudosity account — Sign up for your free account
- API credentials — Found in your account under Developers → API Settings
- Claude Code v1.0.33+ — Run
claude --version to check
Installation
From the official Anthropic marketplace
If approved on the official marketplace:
/plugin install kudosity-sms@claude-plugins-official
From the Kudosity marketplace (GitHub)
Add the Kudosity plugin marketplace and install:
/plugin marketplace add https://github.com/kudosity/kudosity-claude-sms-plugin
/reload-plugins
/plugin install kudosity-sms
Note: Run Claude Code from a directory where you have full read/write permissions (e.g., your project folder). On Windows, avoid running from restricted system directories.
For local development
git clone https://github.com/kudosity/kudosity-claude-sms-plugin.git
cd kudosity-claude-sms-plugin
claude
Claude Code will automatically detect the plugin files (.mcp.json, skills, commands, and agents) from the current directory.
Setup
1. Set your environment variables
Add these to your shell profile (~/.zshrc or ~/.bashrc):
export KUDOSITY_API_KEY="your_api_key"
export KUDOSITY_API_SECRET="your_api_secret"
Then reload your shell:
source ~/.zshrc
2. Verify your credentials
Run the setup command in Claude Code:
/kudosity-sms:setup
This will verify both your V1 and V2 API credentials and show your account balance.
Usage Examples
Create a contact list
"Create a contact list called 'March Campaign' with fields for email and postcode, then add John Doe (0491570156) and Jane Smith (0435795809)"
Send an SMS
"Send an SMS to 0491570156 from 61481074185 saying 'Your order has shipped!'"
"Send an SMS to my 'March Campaign' list saying 'Sale starts tomorrow!'"
Send an MMS
"Send an MMS to 0435795809 with the image at https://example.com/product.jpg, subject 'New Arrival'"
Set up a webhook
"Set up a webhook at https://myapp.com/sms-status to receive SMS delivery status and inbound messages"
Commands
| Command | Description |
|---|
/kudosity-sms:setup | Interactive credential configuration — collects your API Key and Secret, saves them to your shell profile, and validates against both V1 and V2 APIs |
Skills
| Skill | Description |
|---|
send-sms | Send SMS to a single recipient (V2 API) or to contact lists / multiple numbers (V1 API). Supports scheduling, link tracking, and delivery callbacks. |
send-mms | Send multimedia messages with images, GIFs, video, or audio attachments (V2 API). |
create-list | Create contact lists and add contacts for campaign sends (V1 API). |
setup-webhook | Configure webhooks for delivery status, inbound messages, MMS events, link hits, and opt-outs (V2 API). |
Agents
| Agent | Description |
|---|
kudosity-assistant | A specialized messaging assistant that coordinates multi-step Kudosity operations. Understands API routing rules, authentication methods, and can chain multiple operations together. |
API Coverage
| Operation | API Version | Auth Method |
|---|
| Create list | V1 | Basic Auth |
| Add contact to list | V1 | Basic Auth |
| Send SMS (single recipient) | V2 | x-api-key |
| Send SMS (to list / multiple) | V1 | Basic Auth |
| Send MMS | V2 | x-api-key |
| Create/manage webhooks | V2 | x-api-key |
