# Voipms Sms

> OpenClaw skill for sending and retrieving SMS messages via the VoIP.ms API (no Bitwarden dependency).

- Skill: `modbender/voipms-sms` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds add modbender/voipms-sms`
- Raw SKILL.md: https://api.skillmd.com/api/skills/modbender/voipms-sms/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: modbender (https://skillmd.com/u/modbender)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/modbender/voipms-sms

---


# VoIP.ms SMS Skill

Use this skill to send and retrieve SMS messages through the VoIP.ms API.

## Available Scripts

### `scripts/send_sms.py`

Send an SMS from one of your VoIP.ms DIDs to a destination number.

Required arguments:
- `--did`: source VoIP.ms number
- `--dst`: destination phone number
- `--message`: SMS message text

Example:

```bash
python3 scripts/send_sms.py \
  --did "15551234567" \
  --dst "15557654321" \
  --message "Hello from OpenClaw"
```

### `scripts/get_sms.py`

Retrieve SMS messages from the VoIP.ms API for a recent date range.

Arguments:
- `--did` (optional): filter by a specific source number
- `--days` (optional, default `1`): number of days back to fetch

Example (all numbers, last day):

```bash
python3 scripts/get_sms.py --days 1
```

Example (specific DID, last 7 days):

```bash
python3 scripts/get_sms.py --did "15551234567" --days 7
```

## Required Credentials

Set these environment variables before running either script. The Python scripts will read them directly.
Please create a sub-account/dedicated VoIP.ms API account that only has SMS permissions rather than using your main admin credentials.

Example:

```bash
export VOIPMS_API_USERNAME="my_api_username"
export VOIPMS_API_PASSWORD="my_api_password"
```