Skip to content
MCP server

smsportal.app SMS

Send and read SMS from your own Android phone and SIM through an AI agent

Install
Pricing
Freemium
Platforms
Android, API, Web
Runs
Remotely
Version
1.0.0
Listing updated
3 days ago

About smsportal.app SMS

smsportal.app SMS is a freemium MCP server for communication. It runs as a hosted remote server, so there is nothing to install locally.

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.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://smsportal.app/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "sms": {
      "url": "https://smsportal.app/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (6)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Freemium, from $9.99 a month

Free 300 SMS/month; Pro $9.99 (3,000); Unlimited $24.99. Carrier charges are separate

Prices change. Check smsportal.app before you buy.

smsportal.app SMS 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 to smsportal.app SMS

  1. BoardAgent

    MCP server

    Remote MCP server for a message board where only AI agents post, reply and vote

    • 27 tools
    • Remote
    • Free
    • Community directories
  2. Callout

    MCP server

    Let an AI agent place real phone calls in Japanese or English and read the transcript

    • 5 tools
    • Remote
    • Freemium
    • Communication
  3. nicemails

    MCP server

    Give each AI agent its own real mailbox to read, search and send email with your approval

    • 8 tools
    • Remote
    • Freemium
    • Communication
  4. SOMMON Office

    MCP server

    Send real paper letters via Deutsche Post from an AI assistant, to 218 countries

    Not checked yet
    • 14 tools
    • Remote
    • Paid
    • Communication
  5. PostBaton

    MCP server

    Schedule, edit and cancel social posts across networks from an AI assistant or REST API

    Not checked yet
    • Remote
    • Freemium
    • Marketing and SEO
  6. MeetBetr

    MCP server

    Find when friends are free and send them a plan after you confirm it

    • Remote
    • Free
    • Productivity