# SMSTunnel

> SMSTunnel is a freemium MCP server for communication. Send texts from your own Android phone and number through an AI assistant. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** Android, API, CLI
- **Website:** https://smstunnel.io
- **Repository:** https://github.com/narcisbodea/smstunnel-mcp
- **MCP Registry name:** io.github.narcisbodea/smstunnel-mcp
- **Categories:** communication
- **Listing updated:** 2026-11-14

## About

Texts leave through your handset. You ask an AI app to send a message, SMSTunnel hands it to the Android app on your phone, and the phone sends it from its own SIM, so the recipient sees your number and can reply. There is no per-message fee from SMSTunnel, only your carrier's normal rates.

Safety defaults matter here: by default the server asks AI apps that support it to confirm each text, and every tool carries MCP annotations so the client can prompt first. Reading received texts and looking up saved contact names are opt-in switches on the API key, and your phone's own contacts are never shared.

It runs locally over stdio with an API key from the dashboard, or as a one-click Claude Desktop extension.

## Features

- **Your own number:** Texts are sent by your phone, from your SIM.
- **Confirm each text:** Default setting makes supporting AI apps ask before sending.
- **Sign-in codes:** A separate tool sends verification codes with its own allowance.
- **Delivery status:** Check whether a text is pending, sent, delivered or failed.
- **Opt-in inbox:** Let the assistant read received texts when enabled.
- **Claude Desktop extension:** Install from a downloadable .mcpb file.

## Good for

- Text a customer an order update from a chat
- Send an appointment confirmation
- Check whether a message was delivered
- Ask the assistant to text a saved contact by name

## Install

### Claude Code (Terminal)

```sh
claude mcp add smstunnel-mcp --env SMSTUNNEL_API_KEY='<SMSTUNNEL_API_KEY>' -- npx -y @narcisbodea/smstunnel-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "smstunnel-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@narcisbodea/smstunnel-mcp"
      ],
      "env": {
        "SMSTUNNEL_API_KEY": "<SMSTUNNEL_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "smstunnel-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@narcisbodea/smstunnel-mcp"
      ],
      "env": {
        "SMSTUNNEL_API_KEY": "<SMSTUNNEL_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "smstunnel-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@narcisbodea/smstunnel-mcp"
      ],
      "env": {
        "SMSTUNNEL_API_KEY": "<SMSTUNNEL_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "smstunnel-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@narcisbodea/smstunnel-mcp"
      ],
      "env": {
        "SMSTUNNEL_API_KEY": "<SMSTUNNEL_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "smstunnel-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@narcisbodea/smstunnel-mcp"
      ],
      "env": {
        "SMSTUNNEL_API_KEY": "<SMSTUNNEL_API_KEY>"
      }
    }
  }
}
```

## Tools

- `send_sms`: Sends one text to one number.
- `send_sign_in_code`: Sends a verification code of 4 to 10 digits.
- `get_message_status`: Shows whether a text is pending, sent, delivered, failed or unconfirmed.
- `list_phones`: Lists linked phones and which are online.
- `get_usage`: Shows plan and daily usage.
- `list_received_texts`: Reads received texts when enabled.
- `find_contact`: Finds a number by saved name when enabled.

## FAQ

### Do I pay per message?

No. Only your carrier's SMS rates apply.

### What do I need?

The SMSTunnel Android app and an API key from the dashboard.

### Can the assistant read my inbox?

Only if you enable reading received texts on the key and sync in the phone app.

### Is there a free plan?

Yes: 25 texts a day and 500 a month.

### Is SMSTunnel free?

SMSTunnel has a free plan, with paid plans for more usage or features.

### How do I add SMSTunnel to Claude Code?

Run this command in your terminal: claude mcp add smstunnel-mcp --env SMSTUNNEL_API_KEY='<SMSTUNNEL_API_KEY>' -- npx -y @narcisbodea/smstunnel-mcp

### What are the best alternatives to SMSTunnel?

The closest alternatives to SMSTunnel 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/smstunnel
