# smsportal.app SMS

> smsportal.app SMS is a freemium MCP server for communication. Send and read SMS from your own Android phone and SIM through an AI agent. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $9.99 a month
- **Platforms:** Android, API, Web
- **Website:** https://smsportal.app/en/integrations/mcp
- **Repository:** https://github.com/aleksanderem/smsportal-mcp
- **MCP Registry name:** app.smsportal/sms
- **Categories:** communication
- **Listing updated:** 2026-11-14

## About

Messages leave from the SIM in a phone you have paired to your account, so carriers bill them under your own plan and SMS Portal|app charges no per-message fee. The README says it is not affiliated with SMSPortal (Pty) Ltd of South Africa.

The hosted server uses Streamable HTTP with an API key in an Authorization header. OAuth login is not supported. You create a separate key for the agent in the dashboard and can revoke it in one click. Setting SMSPORTAL_READ_ONLY to true removes the sending tool entirely.

Sending takes up to 50 exact E.164 numbers per call, and acceptance is not proof of delivery, so the send-status tool should be checked afterward. After a timeout, check message history before retrying to avoid duplicates. Reading means SMS already synchronised from the phone, not live monitoring.

## Features

- **Send from your SIM:** Texts go out from your own number through a paired Android phone.
- **Read incoming SMS:** Reads messages synchronised from the phone, with filtering and paging.
- **Delivery status:** Per-recipient status for a sent batch.
- **Message search:** Search sent and received history by text, number, phone, status and time.
- **Read-only mode:** An environment variable hides the sending tool.
- **Per-agent key:** Create a separate key for the agent and revoke it any time.

## Good for

- Text appointment reminders from your own number
- Have an agent summarise your latest incoming SMS
- Check whether a batch of messages was delivered
- Search past conversations by number or keyword
- Give an assistant read-only access to incoming codes

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http sms https://smsportal.app/mcp
```

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

```sh
https://smsportal.app/mcp
```

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

```json
{
  "mcpServers": {
    "sms": {
      "url": "https://smsportal.app/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "sms": {
      "type": "http",
      "url": "https://smsportal.app/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "sms": {
      "serverUrl": "https://smsportal.app/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "sms": {
      "type": "http",
      "url": "https://smsportal.app/mcp"
    }
  }
}
```

## Tools

- `smsportal_list_devices`: Phones paired with the account, with heartbeat and SIM state.
- `smsportal_read_received_sms`: Incoming SMS with filtering and pagination.
- `smsportal_send_sms`: Sends a message to explicit recipients from your SIM.
- `smsportal_get_send_status`: Per-recipient status for a sent batch.
- `smsportal_list_messages`: Message history and search.
- `smsportal_get_stats`: Sent, received and device totals.

## FAQ

### Does it charge per message?

No. Plans cover the platform; your carrier bills the messages through your SIM.

### What do the plans cost?

Free is $0 with 300 outgoing SMS a month, Pro is $9.99 for 3,000, and Unlimited is $24.99 with no app limit.

### Does it support OAuth?

No. The server needs a client that can send a custom Authorization bearer header.

### Can I run it locally?

Yes, the repository builds a local stdio server, and an HTTP mode with a Dockerfile.

### Is smsportal.app SMS free?

smsportal.app SMS has a free plan, with paid plans for more usage or features. Paid plans start at $9.99 a month.

### How do I add smsportal.app SMS to Claude Code?

Run this command in your terminal: claude mcp add --transport http sms https://smsportal.app/mcp

### What are the best alternatives to smsportal.app SMS?

The closest alternatives to smsportal.app SMS 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/smsportal-app-sms
