# Campfire SMS [Verified owner] [Health: Active]

**Category:** 💬 Communication  
**Repository:** https://github.com/campfiresms/campfire-mcp  
**GitHub Stars:** 0  
**npm Downloads (last month):** 175  
**Views:** 6  
**Installs:** 1  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/campfire-sms

## Description
CampfireSMS is a two-way SMS transport between a verified phone number and an AI agent. Enroll at campfiresms.com and verify your phone before connecting. Local Codex and Grok Build use npx -y @campfiresms/setup YOUR_INSTALLATION_CODE (Node.js 18+, Python 3.12+); keep the computer online and the agent running. Hosted MCP at https://api.campfiresms.com/mcp requires Authorization: Bearer <installation-credential>; adding the URL alone is insufficient. Grok Bot can wake through a separately configured webhook routine. The agent supplies its own model and tools; SMS replies steer work and do not replace native approvals. Free verification demo, monthly plan, and one-time message packs. Setup: https://campfiresms.com/install.html.

## Tools
Capabilities this server exposes over MCP:

- **campfire_open_bridge** — Open (or reuse) an SMS bridge to your verified phone
- **campfire_send_message** — Send you a text
- **campfire_check_messages** — Retrieve your pending replies (they repeat until acknowledged)
- **campfire_ack** — Acknowledge message IDs after handling them
- **campfire_close_bridge** — Close the bridge when the session is done

## Claude Desktop Quick Installation
Install path inferred — verify against the README before running it. Uses `npx` (confidence: medium):

```json
"mcpServers": {
  "campfire-sms": {
    "command": "npx",
    "args": ["-y","@campfiresms/setup","YOUR_INSTALLATION_CODE"]
  }
}
```

## Documentation

## What Campfire SMS does

Campfire SMS links an AI agent to the phone of the person running it. The agent can send a text when it needs an answer or has completed work, and the operator replies from the phone’s ordinary SMS inbox. No dedicated phone application is required.

The service is intended for communication between an agent and its operator. It is not a general phone number that other people can use to message the agent. The agent continues to use its own model, tools, and permissions; Campfire SMS provides phone enrollment, delivery, message routing, and an authenticated queue.

## How it works

After signing up at campfiresms.com and verifying a phone number, an installation can be created for a local computer or hosted bot. A local MCP host starts the connector and keeps the computer, agent process, and network connection available. The agent opens an SMS bridge, sends messages, checks for replies, and acknowledges message IDs after processing them.

Pending replies remain available until they are acknowledged, so a client can retrieve the same messages again while handling them. A hosted deployment connects to `https://api.campfiresms.com/mcp` over streamable HTTP and must send its installation credential as a bearer token.

For Grok Bot cloud routines, an authenticated hosted connection can be paired with an active webhook routine. That configuration can allow an incoming text to start the routine while the local computer is off.

## Setup and configuration

Begin at campfiresms.com, verify the phone, and copy the one-time installation command from the account. Local setup uses the command below, with the account-specific installation code:

```text
npx -y @campfiresms/setup YOUR_INSTALLATION_CODE
```

The local path requires Node.js 18 or newer, including `npx`, and Python 3.12 or newer. The installation code expires after 10 minutes and can only be used once. Running `npx -y @campfiresms/setup update` refreshes a saved local connection.

Setup detects and registers Codex and Grok Build command-line clients. Other MCP hosts can use the local server name and command printed by setup. On Linux or a virtual machine, run setup as the same non-root user that runs the agent and use a Python virtual environment.

For hosted use, obtain the per-installation credential with the account’s install command and `--credential-only`. Store it in the client’s protected credential settings. Supplying only the hosted URL results in an unauthorized request.

## Tools and capabilities

- `campfire_open_bridge` opens or reuses the SMS bridge for the verified phone.
- `campfire_send_message` sends a text to the operator.
- `campfire_check_messages` retrieves pending operator replies.
- `campfire_ack` marks selected message IDs as handled.
- `campfire_close_bridge` ends the bridge session.

## Limitations and notes

An SMS reply can guide work only within the permissions the agent already has. It does not approve new permissions or replace the agent host’s native approval flow.

SMS is not end-to-end encrypted. Do not send passwords, credentials, payment information, or other secrets through the bridge. Each incoming or outgoing text counts toward the account’s message allowance; messaging stops when that allowance is exhausted.

A local agent cannot be contacted while its computer is stopped or offline. Keeping the machine awake, connected, and running the agent is necessary unless a separately configured hosted webhook routine handles wake-up.

_Full upstream README: https://allmcps.com/mcp/campfire-sms/readme_

