# Voodoo SMS MCP by usefulapi

> Voodoo SMS MCP by usefulapi is an MCP server for communication. Read Voodoo SMS credits, reports, inbox and lists; send one SMS; manage the opt-out blacklist. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Website:** https://usefulapi.io/voodoo-sms/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/voodoo-sms
- **MCP Registry name:** io.usefulapi/voodoo-sms
- **Categories:** communication
- **Listing updated:** 2026-11-13

## About

Read Voodoo SMS credits, reports, inbox and lists; send one SMS; manage the opt-out blacklist.

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http voodoo-sms https://voodoo-sms.usefulapi.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://voodoo-sms.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "voodoo-sms": {
      "url": "https://voodoo-sms.usefulapi.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "voodoo-sms": {
      "type": "http",
      "url": "https://voodoo-sms.usefulapi.io/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "voodoo-sms": {
      "serverUrl": "https://voodoo-sms.usefulapi.io/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "voodoo-sms": {
      "type": "http",
      "url": "https://voodoo-sms.usefulapi.io/mcp"
    }
  }
}
```

## Tools

- `voodoosms_get_credits`: Get the SMS credit balance of the account. One credit pays for one 160-character SMS part (153 characters per part in a long message). Voodoo SMS REST: GET /credits.
- `voodoosms_list_delivery_reports`: List delivery reports of sent messages (message_id, sender_id, to, sent_at, delivered_at, price, status), optionally filtered. Use it to check whether a message was delivered. Dates accept a UNIX timestamp, ISO 8601 (2026-10-01T09:00:00+00:00) or plain English ('yesterday', '2 weeks'). Voodoo SMS REST: GET /report.
- `voodoosms_list_scheduled_messages`: List SMS that were scheduled through the send API and are still waiting to go out (messages scheduled in the portal's Web SMS are not shown). Voodoo SMS REST: GET /schedule.
- `voodoosms_list_inbox`: List SMS received on the account's Virtual Mobile Numbers (replies and keyword messages). Needs a purchased number; an empty inbox returns an empty result. Dates accept a UNIX timestamp, ISO 8601 or plain English. Voodoo SMS REST: GET /inbox.
- `voodoosms_list_numbers`: List the Virtual Mobile Numbers (VMNs) the account has purchased, used to receive SMS. Returns an empty result if there are none. Voodoo SMS REST: GET /numbers.
- `voodoosms_list_contact_lists`: List the account's contact lists (id, name, status, size, created/updated times) without their contacts. Returns an empty result if there are none. Voodoo SMS REST: GET /contacts.
- `voodoosms_get_contact_list`: Get one contact list including its contacts (id, number, status, dynamic_data, created_at). Voodoo SMS REST: GET /contacts?contact_list_id=.
- `voodoosms_list_blacklist`: List the numbers on the account's opt-out blacklist (no SMS is ever sent to them), or look up one number (`{empty: true}` means it is not on the list). Returns an empty result when the blacklist is empty. Voodoo SMS REST: GET /blacklist.
- `voodoosms_send_sms`: WRITE: SENDS A REAL SMS to ONE recipient and USES THE ACCOUNT'S CREDITS (1 credit per message part, charged whether or not it is delivered; it cannot be undone). `sandbox` is required: true validates and prices the message without sending or charging, false sends it for real. Optional `schedule` queues it for later (cancel with cancel_scheduled_message). Do not retry after an error or timeout with
- `voodoosms_cancel_scheduled_message`: WRITE: cancels one SMS that was scheduled through the send API, so it will not be sent. A message that has already gone out cannot be cancelled. Whether credits are refunded for a cancelled message is not documented by the vendor. Voodoo SMS REST: DELETE /schedule/{id}.
- `voodoosms_add_to_blacklist`: WRITE: adds one number to the account's opt-out blacklist; from then on no SMS is sent to it (sends to it fail with error 20). Use it for a recipient who asked to stop. This tool cannot remove a number again. Voodoo SMS REST: POST /blacklist.
- `voodoosms_create_contact_list`: WRITE: creates a new contact list with up to 500 contacts (the list name must be unique, at most 32 characters). It does not send anything. Voodoo SMS REST: POST /contacts.
- `voodoosms_update_contact_list`: WRITE: renames a contact list and/or adds up to 500 contacts to it (existing contacts are not removed). Adding dynamic data needs a list created as dynamic. It does not send anything. Voodoo SMS REST: PUT /contacts/{contact_list_id}.

## FAQ

### How do I add Voodoo SMS MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http voodoo-sms https://voodoo-sms.usefulapi.io/mcp

### What are the best alternatives to Voodoo SMS MCP by usefulapi?

The closest alternatives to Voodoo SMS MCP by usefulapi are BoardAgent, Callout, nicemails, SOMMON Office and PostBaton.

## Alternatives

- [BoardAgent](https://ai-powered.com/mcp/boardagent): BoardAgent is a free MCP server for community directories.
- [Callout](https://ai-powered.com/mcp/callout): Callout is a freemium MCP server for communication.
- [nicemails](https://ai-powered.com/mcp/nicemails): nicemails is a freemium MCP server for communication.
- [SOMMON Office](https://ai-powered.com/mcp/sommon-office): SOMMON Office is a paid MCP server for communication.
- [PostBaton](https://ai-powered.com/mcp/postbaton): PostBaton is a freemium MCP server for marketing and seo.
- [MeetBetr](https://ai-powered.com/mcp/meetbetr): MeetBetr is a free MCP server for productivity.
- [Host Tools](https://ai-powered.com/mcp/host-tools): Host Tools is an MCP server for home services.
- [iMessage MCP](https://ai-powered.com/mcp/imessage-mcp): iMessage MCP is an open-source MCP server for communication.

---
Source: https://ai-powered.com/mcp/voodoo-sms-mcp-by-usefulapi
