Smspm

by alesav

303 downloads
Not rated
GitHub Website

About

MCP server for sending SMS via SMSPM — use with Claude Desktop or any other MCP client

Details

Author
alesav
Downloads
303
Categories
AI

- Node.js 18+
- An SMSPM account with a Hash and API Token
- Your SMSPM_HASH and SMSPM_TOKEN live only in your local config file
- They are never sent to Anthropic or Claude — only to api.smspm.com
- Never commit your config file to version control

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Smspm
    Command (node, npx, python, etc.) npx
    Arguments
    • Argument 1 -y
    • Argument 2 smspm-mcp
    Environment
    • SMSPM_HASH <your-hash>
    • SMSPM_TOKEN <your-token>

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

The README includes setup instructions such as "command": "node",.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "smspm": {
            "command": "npx",
            "args": [
                "-y",
                "smspm-mcp"
            ],
            "env": {
                "SMSPM_HASH": "<your-hash>",
                "SMSPM_TOKEN": "<your-token>"
            }
        }
    }
}

Command

"npx"

Args

[
    "-y",
    "smspm-mcp"
]

Env

{
    "SMSPM_HASH": "<your-hash>",
    "SMSPM_TOKEN": "<your-token>"
}

SMSPM MCP Server

Send SMS messages from Claude Desktop (or any MCP client) using your SMSPM account.

Prerequisites

- Node.js 18+
- An SMSPM account with a Hash and API Token

Installation

Option A — Install from npm (once published)

npm install -g smspm-mcp

Option B — Install from source

git clone https://github.com/alesav/smspm-mcp.git
cd smspm-mcp
npm install
npm run build

Note the full path to the built file — you'll need it in the next step:

/path/to/smspm-mcp/dist/index.js

---

Configure Claude Desktop

Open your Claude Desktop config file:

| Platform | Path |
|----------|------|
| macOS | ~/Library/Application Support/Claude/claude_desktop_config.json |
| Windows | %APPDATA%\Claude\claude_desktop_config.json |

Add the smspm entry inside mcpServers:

{
  "mcpServers": {
    "smspm": {
      "command": "node",
      "args": ["/path/to/smspm-mcp/dist/index.js"],
      "env": {
        "SMSPM_HASH": "your-hash-here",
        "SMSPM_TOKEN": "your-api-token-here"
      }
    }
  }
}

> If installed via npm globally, replace the path with: "npx" as command and ["smspm-mcp"] as args.

Restart Claude Desktop after saving the config.

---

Getting your Hash and Token

1. Log in to smspm.com
2. Go to Settings → API
3. Copy your Hash (looks like e3dbe013-6f66-4fae-8ae2-96c364cb6b61)
4. Copy or generate your API Token

---

Usage

Once configured, just ask Claude:

> "Send an SMS to +37256789045 saying Hello from Claude"

> "Text +447911123456 — your order has shipped"

Claude will use the send_sms tool automatically.

Tool parameters

| Parameter | Required | Description |
|-------------|----------|-------------|
| toNumber | ✅ | Recipient phone in international format (e.g. 37256789045) |
| text | ✅ | Message content |
| fromNumber | ❌ | Sender name/number shown to recipient (default: smspm.com) |

---

Security

- Your SMSPM_HASH and SMSPM_TOKEN live only in your local config file
- They are never sent to Anthropic or Claude — only to api.smspm.com
- Never commit your config file to version control

---

License

MIT

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.