Send SMS, MMS, manage contact lists, and configure webhooks using the Kudosity messaging platform — directly from Gemini CLI.

This extension integrates Gemini CLI 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 Gemini CLI using curl with your own API credentials. The extension connects to a remote MCP server for API documentation lookup only — no message data or credentials are sent through it.

The extension also includes:

• /setup — credential verification command
• kudosity-assistant — a specialized sub-agent for coordinating multi-step messaging operations

1. Kudosity account — Sign up for your free account
2. API credentials — Found in your account under Developers → API Settings
3. Gemini CLI — Install Gemini CLI

gemini extensions install https://github.com/kudosity/gemini-kudosity-sms-extension

git clone https://github.com/kudosity/gemini-kudosity-sms-extension.git
cd gemini-kudosity-sms-extension
gemini extensions link .

When you install the extension, Gemini CLI will prompt you for your API Key and Secret. These are stored securely in your system keychain.

To reconfigure credentials later:

gemini extensions config gemini-kudosity-sms-extension

Or set environment variables manually in your shell profile (~/.zshrc or ~/.bashrc):

export KUDOSITY_API_KEY="your_api_key"
export KUDOSITY_API_SECRET="your_api_secret"

Run the setup command in Gemini CLI:

/setup

This will verify both your V1 and V2 API credentials and show your account balance.

"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 to 0491570156 from 61481074185 saying 'Your order has shipped!'"

"Send an SMS to my 'March Campaign' list saying 'Sale starts tomorrow!'"

"Send an MMS to 0435795809 with the image at https://example.com/product.jpg, subject 'New Arrival'"

"Set up a webhook at https://myapp.com/sms-status to receive SMS delivery status and inbound messages"

Note: Sub-agents are an experimental feature in Gemini CLI. The extension's GEMINI.md context file provides equivalent instructions as a fallback.

The full API specifications are available as OpenAPI documents:

• V1: api_documentation.yml — Lists, contacts, bulk SMS
• V2: public-openapi.yaml — Single SMS, MMS, webhooks

This extension has two distinct components with different trust boundaries:

The extension connects to the public Kudosity MCP server at developers.kudosity.com/mcp. This server provides API documentation and endpoint metadata only. It does not execute API operations, receive message content, or have access to your credentials.

MCP tools available:

• list-specs, list-endpoints, get-endpoint, search-endpoints — browse and search API documentation
• route-kudosity-operations — determines which API version to use for a given operation

All actual API operations (sending messages, creating lists, configuring webhooks) are executed locally by Gemini CLI on your machine using curl commands. API calls go directly from your machine to the Kudosity API servers:

• V1 API (api.transmitsms.com) — Basic Auth with -u flag
• V2 API (api.transmitmessage.com) — x-api-key header

Your credentials are never sent to the MCP server or to Gemini. They are used only in direct API calls to Kudosity.

• Credentials are stored securely in your system keychain (when configured via gemini extensions config) or as environment variables. They are not embedded in any extension file, sent to Gemini, or transmitted to any remote service other than the Kudosity API during authenticated requests.
• API calls are executed locally by Gemini CLI using curl. Requests go directly from your machine to the Kudosity API — they do not pass through the MCP server or any intermediary.
• MCP server access is read-only — it serves API documentation and endpoint metadata only. No credentials, message content, or user data are sent to it.
• No telemetry or analytics are collected by this extension.

If you installed Gemini CLI via Homebrew, you may see this error repeated several times when running gemini extensions install, uninstall, or config:

Keychain initialization encountered an error: Cannot find module '../build/Release/keytar.node'
Using FileKeychain fallback for secure storage.

This is a known issue with the Homebrew packaging of Gemini CLI — the native keychain module isn't included. Your credentials are still stored securely. Gemini CLI automatically falls back to an encrypted local file for credential storage. The error is cosmetic and can be safely ignored.

├── gemini-extension.json          # Extension manifest
├── GEMINI.md                      # Persistent context/instructions
├── skills/
│   ├── create-list/SKILL.md       # Contact list management
│   ├── send-sms/SKILL.md         # SMS sending
│   ├── send-mms/SKILL.md         # MMS sending
│   └── setup-webhook/SKILL.md    # Webhook configuration
├── agents/
│   └── kudosity-assistant.md      # Specialized messaging sub-agent
├── commands/
│   └── setup.toml                 # Credential verification command
├── .gitignore
├── CHANGELOG.md
├── LICENSE
├── PROJECT.md
└── README.md

• API Documentation: developers.kudosity.com
• MCP Server: developers.kudosity.com/mcp
• V1 API Spec (OpenAPI): api_documentation.yml
• V2 API Spec (OpenAPI): public-openapi.yaml
• Kudosity Support: kudosity.com

MIT — see LICENSE