Campfire SMS
Setup

Connect your phone to your agents

First, create your Campfire SMS account and verify your phone. Then connect ChatGPT, Grok Bot to wake when you text, or an active local coding agent for updates and replies.

Campfire SMS works with US and Canadian mobile numbers for now.

Which path is for me? Using ChatGPT? → ChatGPT plugin. Want texts answered while your PC is off? → Grok Bot. Working in Codex, Claude Code, Grok Build, or OpenCode on your computer? → Local agents. Using Cursor? → Cursor. Something not working? → Troubleshooting and FAQ.

ChatGPT: the Campfire SMS plugin

ChatGPT can text you and read your replies. In a Work chat, it can also subscribe to your replies so a text picks the task back up. Nothing to install on your computer.

  1. Create your account and verify your phone, then choose your PIN. Skip the install command on the last screen.
  2. Open Campfire SMS in ChatGPT (or find it under Plugins or Apps), install it, and choose Connect.
  3. Sign in with your phone number and PIN, and choose Connect.
  4. In a chat, type @Campfire SMS, ask it to text you a test, and reply.

The ChatGPT setup guide covers the approval prompt, Work wake, and common fixes.

Grok Bot: hosted MCP and webhook wake

A text can trigger Grok’s cloud routine even while your PC is off. The Bot reads the message through Campfire SMS’s hosted MCP and can reply by SMS.

  1. Create your account and verify your phone. Then sign in, go to Add computers, open Add a computer or Bot, and choose Create install command. Run the command your account shows, adding --credential-only. It saves the installation credential to a file and prints where.
  2. Connect https://api.campfiresms.com/mcp in Grok’s secure plugin or MCP settings using that installation’s credential.
  3. Create an active webhook routine, then save its URL and key under Grok Bot 24/7 wake in your Campfire SMS account.
  4. Send a real text. Check the webhook run, message retrieval, and SMS reply.

The Grok Bot walkthrough covers enrollment, secure credentials, the routine instruction, and the complete test. Hosted MCP requires no Python or pip installation.

Local agents: install the connector

Use this path for Codex, Grok Build, Claude Code, Cursor, OpenCode, or another compatible MCP host running on your computer. Grok Build is Grok’s coding agent on your computer; unlike Grok Bot, it can’t be woken by a text while your PC is off. You need Windows, macOS, or Linux, Node.js 18+ with npx, and Python 3.12+. Keep the computer awake and online with the agent running. The local connector does not wake stopped sessions.

  1. Verify your phone

    Start free setup to create your account. Campfire SMS sends a verification code. Choose and confirm a six-digit account PIN; later sign-ins use your phone number and PIN.

  2. Run your installation command

    Sign in, go to Add computers, open Add a computer or Bot, give the computer a label, and choose Create install command. Your account then shows the command with your installation code. Copy it and run it on the computer where your agent runs:

    Installing on Linux or a VM? Do this first.

    Run setup as the same non-root user that runs the agent. Use Python 3.12+ with venv support and activate an isolated environment before running the one-time command:

    python3 -m venv "$HOME/.local/share/campfire/venv"
    . "$HOME/.local/share/campfire/venv/bin/activate"
    # Now run the npx setup command from your account.

    Do not use sudo pip, global/system pip, or --break-system-packages. If venv support is missing, have the VM administrator install the matching Python venv package.

    Set the MCP server command to the virtual environment’s absolute Python path, such as /home/agent/.local/share/campfire/venv/bin/python -m campfire_mcp.cli serve. Future runs do not inherit shell activation.

    npx -y @campfiresms/setup YOUR_INSTALLATION_CODE

    The command is single use and expires after 10 minutes. If it expires, create a new one.

  3. Connect your agent

    Setup stores the installation credential locally and adds Campfire SMS to each agent app it finds: Codex, Claude Code, Cursor, and Grok Build. For another compatible agent, add a local MCP server named campfire using the command printed by setup. Open or restart the agent.

  4. Test both directions

    Send the account’s test message and reply TEST. Wait for the setup confirmation. Then ask your running agent to open a bridge, text you, retrieve a harmless reply, and respond.

Cursor

Found Campfire SMS on Cursor Directory? The easiest way to connect it is the install command below. It adds Campfire SMS to Cursor for you, with no token to copy. Setup takes about five minutes.

  1. Check the requirements

    You need Node.js 18+ and Python 3.12+ on the computer where Cursor runs. Open Cursor at least once before setup so its settings folder exists. No Python? Use the Add to Cursor button instead.

  2. Create your install command

    Start free setup, verify your phone, and choose your PIN. Then go to Add computers, open Add a computer or Bot, and choose Create install command.

  3. Run it

    Paste the command into a terminal. Cursor’s own terminal works (Terminal → New Terminal). Setup adds a server named campfire to Cursor’s global settings file, ~/.cursor/mcp.json, and keeps your other servers. When it finishes, Cursor should be in its list of connected apps.

    npx -y @campfiresms/setup YOUR_INSTALLATION_CODE

    Already set up Campfire SMS on this computer for another agent? Run npx -y @campfiresms/setup@latest update instead. It adds Cursor without a new code.

  4. Restart Cursor and check the server

    Quit Cursor completely and reopen it. Open Cursor Settings (Ctrl+, on Windows and Linux, Cmd+, on Mac), go to the MCP section (named Tools & MCP in many versions), and make sure campfire is on with a green dot. If you clicked Add to Cursor on Cursor Directory earlier, you’ll also see a second Campfire SMS server with an error. Turn that one off. The campfire server from the install command does the same job without a token.

  5. Test it

    Send the account’s test message and reply TEST. Then ask Cursor’s agent: “Use Campfire to text me ‘Hello from Cursor. Reply with any word.’ Then check for my reply.” Reply to the text. The agent reads your reply the next time it checks Campfire.

No Python? Use the Add to Cursor button.

The Add to Cursor button on Cursor Directory connects Cursor to the hosted server at https://api.campfiresms.com/mcp. It needs no Python, but it reads your installation credential from an environment variable named CAMPFIRE_TOKEN, so set that up first.

  1. Create an install command as above and run it with --credential-only added at the end. Setup saves the credential and prints the file’s location: %LOCALAPPDATA%\Campfire\config.json on Windows, or ~/.config/campfire/config.json on macOS and Linux.
  2. Open that file and copy the credential value, which starts with cfi_. Treat it like a password. Never paste it into a chat, an issue, or a repo.
  3. Save it as an environment variable named CAMPFIRE_TOKEN. On Windows, run this in PowerShell:
    [Environment]::SetEnvironmentVariable("CAMPFIRE_TOKEN", "PASTE_CREDENTIAL_HERE", "User")
    On macOS or Linux, add this line to ~/.zshrc or ~/.bashrc:
    export CAMPFIRE_TOKEN="PASTE_CREDENTIAL_HERE"
  4. Quit Cursor completely and reopen it so it picks up the variable. Then click Add to Cursor on the Cursor Directory listing and confirm the install in Cursor.
  5. Check that the new Campfire SMS server has a green dot in Cursor’s MCP settings. Then test it as above.

Prefer to add it by hand? Put this in ~/.cursor/mcp.json. If the file already lists servers, add the campfire entry inside its existing mcpServers.

{
  "mcpServers": {
    "campfire": {
      "url": "https://api.campfiresms.com/mcp",
      "headers": { "Authorization": "Bearer ${env:CAMPFIRE_TOKEN}" }
    }
  }
}

For client-specific steps, use Codex SMS setup or Claude Code SMS setup. Use the local-agent notifications guide to choose when the agent should text, or the away-from-desk guide to prepare a task.

Account verification and installations

These screenshots show the account interface with fictional sample data.

After phone verification, create and confirm a six-digit account PIN.
The PIN is used for later account sign-ins.
A sample Work laptop installation with a Rename field and Save name and Revoke access buttons.
Each installation has a separate credential. Use Save name to rename it or Revoke access to disable it.

Update or recover a local connection

If an installation command has expired or was already used, sign in and create a new one. If your saved credential is valid, refresh the local connector with:

npx -y @campfiresms/setup@latest update

If the credential was revoked or is missing, create a new installation instead. Restart the agent and test the message round trip. Check your account’s message balance if delivery still fails. For error codes and missing replies, see troubleshooting and FAQ.

Revoke an installation

Sign in, find the installation under Add computers, and open Manage installation. Use Save name to identify it or Revoke access to disable its credential. For Grok Bot, disable wake and pause its routine first.

Remove a local connector

After revoking the installation, remove the MCP entry from each CLI you use:

codex mcp remove campfire
grok mcp remove campfire
claude mcp remove campfire --scope user

For Cursor, delete the campfire entry from ~/.cursor/mcp.json, or turn it off in Cursor’s MCP settings.

For OpenCode, delete the campfire entry from the mcp section of your OpenCode config (usually ~/.config/opencode/opencode.json, or opencode.json in your project). For any other MCP host, remove the campfire server in its MCP settings.

See pricing and message counting for plan and credit options.