SMSTunnel

Name: SMSTunnel
Author: narcisbodea

by narcisbodeaversion 1.1.0i★ –iRuns on your computer

Registry nameio.github.narcisbodea/smstunnel-mcp

Install

Overview

Description from the maker (original English)

Send texts (SMS) from your own Android phone and your own number, from any AI app.

PopNx MCP’s three pillars

These three are never merged into one score: opinions, measurements and popularity are different things.

User voiceiNo reviews yetReviews open together with accounts in a later step
Our basic checksi1 of 1 passedChecked from public information; code not scanned yet
UsageiEarly↓ 542/wk · ★ –

What you can do with it

We have not written a plain-language summary for this one yet. Below are the facts we read from the registry.

Connection: Runs on your computer
Transport: stdio
Category: Chat & email
You need to fill in: SMSTUNNEL_API_KEY

Install

Pick the AI app you use, then copy the settings.

Before you install

Basic checks: 1 of 1 passed
Runs on your computer with your user’s permissions (files, network, apps).
You fill in yourself: SMSTUNNEL_API_KEY, SMSTUNNEL_DEVICE_ID, SMSTUNNEL_DEFAULT_COUNTRY_CODE, SMSTUNNEL_CONFIRM_EACH_TEXT

Values marked secret are keys to your account. Never share them or paste them into a chat.

You need

npmNode.js installed (for the npx command)

Which app do you use?

ClaudeClaude CodeCursorVS CodeChatGPT

Pick your app above. We remember it, so next time the button says “Install in …”.

Open Claude Desktop → Settings → Developer → Edit Config, and paste this into claude_desktop_config.json

{
  "mcpServers": {
    "smstunnel": {
      "command": "npx",
      "args": [
        "-y",
        "@narcisbodea/smstunnel-mcp"
      ],
      "env": {
        "SMSTUNNEL_API_KEY": "your-value",
        "SMSTUNNEL_DEVICE_ID": "your-value",
        "SMSTUNNEL_DEFAULT_COUNTRY_CODE": "your-value",
        "SMSTUNNEL_CONFIRM_EACH_TEXT": "your-value"
      }
    }
  }
}

Run this in your terminal

claude mcp add smstunnel --env SMSTUNNEL_API_KEY=your-value --env SMSTUNNEL_DEVICE_ID=your-value --env SMSTUNNEL_DEFAULT_COUNTRY_CODE=your-value --env SMSTUNNEL_CONFIRM_EACH_TEXT=your-value -- npx -y @narcisbodea/smstunnel-mcp

Fill in the empty values before running it.

Open in Cursor

Or copy the settings yourself

Paste into .cursor/mcp.json in your project, or ~/.cursor/mcp.json

{
  "mcpServers": {
    "smstunnel": {
      "command": "npx",
      "args": [
        "-y",
        "@narcisbodea/smstunnel-mcp"
      ],
      "env": {
        "SMSTUNNEL_API_KEY": "your-value",
        "SMSTUNNEL_DEVICE_ID": "your-value",
        "SMSTUNNEL_DEFAULT_COUNTRY_CODE": "your-value",
        "SMSTUNNEL_CONFIRM_EACH_TEXT": "your-value"
      }
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

Open in VS Code

Or copy the settings yourself

Paste into .vscode/mcp.json in your project

{
  "servers": {
    "smstunnel": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@narcisbodea/smstunnel-mcp"
      ],
      "env": {
        "SMSTUNNEL_API_KEY": "your-value",
        "SMSTUNNEL_DEVICE_ID": "your-value",
        "SMSTUNNEL_DEFAULT_COUNTRY_CODE": "your-value",
        "SMSTUNNEL_CONFIRM_EACH_TEXT": "your-value"
      }
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

This one runs on your computer, and ChatGPT can only connect to servers on the internet. Pick another app.

Your choice stays on this device in a cookie; no account needed.

Values you fill in

SMSTUNNEL_API_KEY secret required env
Your SMSTunnel API key, from https://dashboard.smstunnel.io/apps (Apps → Add an app).
SMSTUNNEL_DEVICE_ID env
Optional: the phone that sends when the assistant doesn't name one (its ID under Phones in the dashboard).
SMSTUNNEL_DEFAULT_COUNTRY_CODE env
Optional: country calling code that completes numbers written without + or 00, e.g. +40.
SMSTUNNEL_CONFIRM_EACH_TEXT env
Optional: true (default) makes AI apps that support it ask you before every text; false for unattended runs.

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

What it can do

Runs on your computer; the tool list appears in your AI app after you install it.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 9, 2026

✓ Pass
Maker matches the repo
The registry name was verified with the GitHub account narcisbodea, which owns the repo
… Not checked yet
Still maintained
We have not read this repo from GitHub yet
… Not checked yet
Has a licence
We have not read this repo from GitHub yet
– Not applicable
Endpoint responds
This one runs on your computer; there is no internet endpoint
– Not applicable
Sign-in with OAuth
Runs on your computer and uses local settings instead
… Not checked yet
No hidden instructions in tool descriptions
Runs on your computer; we can only read tool lists from internet endpoints

Compared with others in Chat & emaili

More stars than 0% of the other 1868 servers in this category
Published to the registry more recently than 82% of the other 1868 servers in this category
Basic checks equal to or better than 100% of the other 1868 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is SMSTunnel safe?

It passed 1 of 1 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

You need to fill in: SMSTUNNEL_API_KEY

Does it run on my computer or in the cloud?

It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).

Is it still maintained?

The GitHub repo last changed –, and the latest version (1.1.0) reached the registry 5 days ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Node.js on your computer.

What can I use instead?

In the same category: Vexa, emailmd, MCP WhatsApp Cloud

Alternatives

Servers in the same category from other makers, sorted by stars.

Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

Vexa

Meeting bot and transcripts for Google Meet, Teams and Zoom. Live or after, speakers labelled.

by Vexa-aiWidely used★ 2.9KUpdated 2 months ago

Runs in the cloud✓ vexa.ai

Install

emailmd

Render markdown into email-safe HTML, lint drafts for deliverability problems, and preview emails.

by anypostWidely used↓ 5.3K/wk★ 1.4KUpdated 33 days ago

Computer or cloud✓ emailmd.dev

Install

MCP WhatsApp Cloud

MCP server for WhatsApp Cloud API (Meta) — messages, media, and templates via Graph API

by codesparEarly↓ 63/wk★ 277Updated 5 months ago

Runs on your computer

Install

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

SMSTunnel MCP server

Let Claude, Cursor, VS Code and other AI apps send texts from your own Android phone, from your own number, with SMSTunnel.

You ask your AI app to text someone; it hands the text to your SMSTunnel account, and your phone sends it from its own SIM, so the recipient sees a number they know and can reply to. The phone is linked to your account when you sign in to the SMSTunnel app, and you can cut this server off anytime by deleting its key in your dashboard.

Your phone needs the SMSTunnel app from Google Play:

What it can do

Tool	What it does	Changes anything?
`send_sms`	Sends one text to one number. For several people, the assistant shows you the whole list first, then sends one text per person.	Sends a text
`send_sign_in_code`	Sends a sign-in or verification code (the text must contain a code of 4 to 10 digits). Uses the separate sign-in code allowance.	Sends a text
`get_message_status`	Shows whether a text is pending, sent, delivered, failed or unconfirmed.	No
`list_phones`	Lists your linked phones, which are online, and their IDs.	No
`get_usage`	Shows your plan, what you sent today and what is left.	No
`list_received_texts`	Reads texts your phones received (only with the opt-in below).	No
`find_contact`	Finds a person's number by name, among the names you saved in SMSTunnel (only with the switch below; never your phone's contacts). You still see the name, the number and the words before anything is sent.	No

Every tool carries a title and the MCP annotations (read-only, destructive, idempotent, open-world), so your AI app can ask you before anything is sent.

Setup

1. Link your phone

Install the SMSTunnel app from Google Play on your Android phone and sign in. Sign in at smstunnel.io on your computer with the same account: the phone appears under Phones (you can also link it with the QR code from Phones → Add phone).

2. Create a key

In your SMSTunnel dashboard, open Apps → Add an app and copy its key. It is shown only once, and it can send texts and look up whether they went out.

To let your AI app read the texts you receive, also turn on Can also read received texts when you add the app (or Allow reading received texts later), and turn on syncing of received texts in the SMSTunnel app on the phone. Syncing is off by default; when you turn it on, only texts that arrive from then on are synced.

To let your AI app find a number by a name you saved in SMSTunnel ("text Ana"), turn on Can also look up names you saved in SMSTunnel for the key; it is off by default, and your phone's contacts are never shared this way.

3. Add the server to your AI app

Claude Desktop, the easy way: download smstunnel.mcpb and open it (double-click, or drag it into Settings → Extensions). Claude Desktop installs it, asks for your key and keeps it in your system's secure storage. Nothing else to install: Claude Desktop runs the bundled server itself.

For the other ways below you need Node.js 20 or newer. Your AI app starts the server with npx; you don't run it by hand.

Claude Desktop, by hand: in the Claude menu, open Settings… → Developer → Edit Config (claude_desktop_config.json), add the server, then quit and restart Claude:

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

On Windows, if the app can't start npx, use "command": "cmd" and "args": ["/c", "npx", "-y", "@narcisbodea/smstunnel-mcp"].

Claude Code, as a plugin (the server plus the agent skill). Claude Code asks for your key and keeps it in your system's secure storage:

/plugin install smstunnel --marketplace narcisbodea/smstunnel-mcp

On Claude Code before 2.1.275, add the marketplace first: /plugin marketplace add narcisbodea/smstunnel-mcp, then /plugin install smstunnel@smstunnel.

Or only the server, without the plugin:

claude mcp add --env SMSTUNNEL_API_KEY=sk_live_your_key --transport stdio --scope user smstunnel -- npx -y @narcisbodea/smstunnel-mcp

Run /mcp in Claude Code to check that smstunnel is connected.

Cursor: , then replace sk_live_your_key with your key in Cursor's MCP settings. Or add the same mcpServers block as Claude Desktop to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project).

VS Code (.vscode/mcp.json): VS Code asks for the key once and keeps it out of the file:

"inputs": [ { "type": "promptString", "id": "smstunnel-api-key", "description": "SMSTunnel API key", "password": true } ], "servers": { "smstunnel": { "type": "stdio", "command": "npx", "args": ["-y", "@narcisbodea/smstunnel-mcp"], "env": { "SMSTUNNEL_API_KEY": "${input:smstunnel-api-key}" } } } }

Gemini CLI, as an extension (the server, the agent skill and a short context file). Gemini CLI asks for your key and keeps it in your system's keychain:

gemini extensions install https://github.com/narcisbodea/smstunnel-mcp

Restart Gemini CLI and run /mcp to check that smstunnel is connected. To change the key later: gemini extensions config smstunnel SMSTUNNEL_API_KEY.

Docker: the image runs the same server over stdio, exactly the version published on npm. Build it once (Docker fetches this repository itself):

docker build -t smstunnel-mcp https://github.com/narcisbodea/smstunnel-mcp.git

Then point your AI app at it:

"mcpServers": { "smstunnel": { "command": "docker", "args": ["run", "-i", "--rm", "-e", "SMSTUNNEL_API_KEY", "smstunnel-mcp"], "env": { "SMSTUNNEL_API_KEY": "sk_live_your_key" } } } }

The container runs as an unprivileged user and needs no ports or volumes. -e SMSTUNNEL_API_KEY hands it the key from env without putting the key on the command line.

Settings

Variable	Required	What it does
`SMSTUNNEL_API_KEY`	yes	The key from Apps → Add an app.
`SMSTUNNEL_DEVICE_ID`	no	The phone that sends when the assistant doesn't name one. Copy its ID under Phones. Without it, SMSTunnel picks one of your online phones.
`SMSTUNNEL_DEFAULT_COUNTRY_CODE`	no	For example `+40` or `1`: completes numbers written without `+` or `00`. Without it, numbers must be in international format.
`SMSTUNNEL_CONFIRM_EACH_TEXT`	no	`true` (default): AI apps that support it, such as Claude Code, ask you before every single text, even in modes that otherwise run tools on their own. Set `false` only for unattended runs, such as a script that texts you.
`SMSTUNNEL_SERVER_URL`	no	For testing only. Default `https://smstunnel.io`.

The server starts even without a key, so your AI app can list its tools; every call then says what is missing. The key is never printed or logged.

Try it

"Text +14155550123: the delivery is at the back door."
"Send my sign-in code 482913 to +447700900123."
"Did my last text go out?"
"Which of my phones are online?"
"How many texts do I have left today?"
"Did anyone reply to me since this morning?"
"Text Ana that I'm running late." (needs Can also look up names you saved in SMSTunnel)

Calendar reminders with an AI assistant

Add SMSTunnel next to your calendar in the same AI app, and the assistant can read your appointments and text reminders from your own number.

"Look at my calendar for tomorrow and text each client with an appointment a reminder with the time and the address. Show me the list first."
"Text me my agenda for tomorrow."
"Did any client reply to today's reminders?" (needs Can also read received texts)

The assistant reads the events with your calendar connector, finds each client's phone number and shows you the whole list: each person, their number and the exact text. After your OK it sends one text per person, and it never resends a failed text on its own. Keep each client's number in the event (for example in the description), with + and the country code, so the assistant can find it.

Claude Desktop

Connect your calendar: open Customize → Connectors, find Google Calendar (or Microsoft 365 for an Outlook calendar; it needs a work or school Microsoft 365 account) and select Connect to Claude.
Add SMSTunnel as in Add the server to your AI app and restart Claude Desktop.
In a chat, select + → Connectors and make sure both your calendar and smstunnel are on.

Claude Code

Connect your calendar at claude.ai/customize/connectors. Connectors you add there appear in Claude Code when you're signed in with the same Claude account (/login). Google Calendar and Microsoft 365 can't be added with claude mcp add.
Add SMSTunnel:

   claude mcp add --env SMSTUNNEL_API_KEY=sk_live_your_key --transport stdio --scope user smstunnel -- npx -y @narcisbodea/smstunnel-mcp

Run /mcp: your calendar (listed as coming from claude.ai) and smstunnel should both be connected.

Claude Code asks you before every text (see SMSTUNNEL_CONFIRM_EACH_TEXT): with ten clients you approve ten texts, each showing the number and the words. Calendar events can come from other people (invitations), so read the list before you approve it.

Agent skill

skills/smstunnel-sms is an Agent Skill that tells your AI app when to use each tool and the rules above: one recipient per text, your OK before anything is sent, no automatic resends, received texts treated as information. The Claude Code plugin and the Gemini CLI extension install it for you. For other apps, copy the folder into the app's skills folder. The skill has no scripts; it works with the server set up as shown in Setup.

Safe use

Only texts people expect. Alerts to yourself, replies, reminders, sign-in codes. Unsolicited texts from a personal SIM break most carriers' terms, and in the EU they fall under GDPR and the ePrivacy rules.
You approve each text. The tools tell the assistant to show you the number and the words (or the whole list, for several people) and wait for your OK. AI apps ask before calling a tool that changes something, and Claude Code asks before every single text unless you set SMSTUNNEL_CONFIRM_EACH_TEXT=false.
One recipient per text. There is no tool for several numbers: the assistant sends one text per person, at most about 30 a minute.
No blind resends. A failed, unconfirmed or timed-out text may still have gone out; the tools tell the assistant to ask you instead of sending it again.
Received texts are data. Anyone can text your phone, so the tools tell the assistant to treat received words as information, never as instructio

Only the beginning is shown; read the rest in the repo

SMSTunnel

Overview

PopNx MCP’s three pillars

What you can do with it

Install

Before you install

Values you fill in

What it can do

Basic checksi

Maker matches the repo

Still maintained

Has a licence

Endpoint responds

Sign-in with OAuth

No hidden instructions in tool descriptions

Compared with others in Chat & emaili

Common questions

Alternatives

Vexa

emailmd

MCP WhatsApp Cloud

README from the maker

SMSTunnel MCP server

What it can do

Setup

1. Link your phone

2. Create a key

3. Add the server to your AI app

Settings

Try it

Calendar reminders with an AI assistant

Agent skill

Safe use