Campfire SMS

io.github.campfiresmsv0.1.0更新于 Oct 10, 2026

Hosted two-way SMS bridge: your coding agent texts you when it needs an answer; you reply by SMS.

已验证Streamable HTTP可网页运行Productivity & WorkflowCommunication & Collaboration

概览

AI 生成的概览

托管的双向短信桥接服务，让助手通过短信向你询问或汇报，并读取你的短信回复。

功能
Campfire SMS 通过短信把智能体连接到你已验证的手机号。工具可以打开或复用桥接、向你发送短信、获取待处理回复、确认已处理的消息 ID，以及关闭桥接。该服务负责手机号登记、短信投递、带认证的消息队列和路由；智能体仍使用自己的模型、工具和权限继续工作。
适用场景
适合长时间运行或无人值守的智能体需要就某个决定联系你、或汇报结果，而你更愿意在普通短信收件箱里回复而不是盯着终端。它的用途是把智能体连接到运行它的人，而不是给智能体一个供他人发短信的号码。
运行要求
远程 streamable HTTP 端点 api.campfiresms.com，以及来自 campfiresms.com 账户的按安装发放的 bearer 凭据（需先注册并验证手机号），通过 Authorization 请求头发送。使用账户安装命令进行本地设置需要 Node.js 18+（含 npx）和 Python 3.12+；仅获取凭据的选项只需 Node.js 18+。电脑必须保持唤醒、联网，并让智能体会话持续运行。
安装前请注意
必须提供 Authorization bearer 凭据，且只应保存在客户端的安全凭据设置中。短信不是端到端加密的，不要发送密码、凭据或支付信息。短信回复不会给智能体新增权限，但可以在其现有权限范围内引导工作。每发送或接收一条短信计为一条消息，额度用完后消息功能会暂停。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Campfire SMS，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "campfire-mcp": {
      "type": "http",
      "url": "https://api.campfiresms.com/mcp"
    }
  }
}

README

Campfire SMS MCP

[Listed on mcpservers.org]

Text your agent. Campfire SMS is a hosted two-way SMS bridge: your agent texts you when it needs an answer or has a result, and you reply by SMS from your normal text inbox.

Don't pip install this repo or use an npx package name without an installation code. Start at campfiresms.com.

How it works

  • Your agent opens a bridge and sends you a text when it needs input or finishes something.
  • You reply from your phone's normal text inbox. No phone app to install.
  • The agent retrieves your reply and keeps working with its own model, tools, and permissions. Campfire SMS handles phone enrollment, SMS delivery, the authenticated message queue, and routing.

Campfire SMS is not a service that gives an agent a phone number for other people to text. It connects your agent to you, the person running it.

Install (through campfiresms.com)

  1. Sign up at campfiresms.com.
  2. Verify your phone. You get 40 free messages, no card required.
  3. Copy the one-time install command from your account (Add computers → Add a computer or Bot → Create install command).

Full instructions: campfiresms.com/install.html

Local agents

For Codex, Claude Code, Grok Build, OpenCode, or another compatible MCP host on your computer. Run the command your account shows:

text
npx -y @campfiresms/setup YOUR_INSTALLATION_CODE
  • YOUR_INSTALLATION_CODE comes from your account. The command is single use and expires after 10 minutes; if it expires, create a new one.
  • Requires Node.js 18+ (with npx) and Python 3.12+.
  • Setup stores the installation credential locally and registers detected Codex and Grok Build CLIs. For other hosts, add a local MCP server named campfire using the command setup prints.
  • On Linux or a VM, run setup as the same non-root user as the agent, inside a Python virtual environment. Don't use sudo pip, system pip, or --break-system-packages. See the Linux/VM instructions.
  • Keep the computer awake and online with the agent session running. Campfire SMS does not wake a stopped local session.

To refresh a saved local connection: npx -y @campfiresms/setup update

Hosted MCP

Streamable HTTP endpoint:

text
https://api.campfiresms.com/mcp

It requires a per-installation bearer credential from your account, sent as Authorization: Bearer <credential>. It does not work without that credential: adding the URL alone (for example, through a directory's one-click install) gets HTTP 401.

To get the credential, run your account's install command with --credential-only (needs Node.js 18+, no Python or pip). Put the credential only in your client's secure credential settings.

Example for Grok Bot cloud routines: connect the hosted MCP with the credential, then set up an active webhook routine and save its URL and key under Grok Bot 24/7 wake in your account. An incoming text can then start the routine while your PC is off. See the Grok Bot walkthrough.

Tools

ToolPurpose
campfire_open_bridgeOpen (or reuse) an SMS bridge to your verified phone
campfire_send_messageSend you a text
campfire_check_messagesRetrieve your pending replies (they repeat until acknowledged)
campfire_ackAcknowledge message IDs after handling them
campfire_close_bridgeClose the bridge when the session is done

Limits and safety

  • SMS replies don't grant the agent new permissions. They can steer work within the agent's existing permissions; native approvals stay in the agent.
  • SMS is not end-to-end encrypted. Don't text passwords, credentials, payment details, or other secrets.
  • Each text sent or received counts as one message. Messaging pauses when your messages run out. See pricing.

Links

About this repository

This repository holds the source of the earlier v0.1.1 Python connector, for reference. The current @campfiresms/setup installer bundles the maintained connector. For a new installation, use the steps above, not this source.

来源：README.md，提交 350dff3

工具

0
工具元数据尚未被收录。

版本历史

1
  1. v0.1.0最新Oct 10, 2026