Campfire SMS
Hosted two-way SMS bridge between a phone and coding agents.
Hosted MCP Server
npx add-mcp 'https://api.campfiresms.com/mcp'Installs into Claude Code, Codex, Cursor and more
Documentation
Campfire MCP
Campfire MCP connects a local Codex session to the Campfire SMS transport. Campfire carries messages; your Codex runtime supplies the model, tools, and permissions.
Install on Windows
Requires Python 3.12 or newer.
py -m pip install "campfire-mcp @ https://github.com/campfiresms/campfire-mcp/archive/refs/tags/v0.1.1.zip"
py -m campfire_mcp.cli configure
configure asks for the service URL and the one-time installation credential
shown after signup. It stores the credential under your local user profile with
restricted permissions, validates it with Campfire, and registers the STDIO
server through codex mcp add when the Codex CLI is available.
Restart ChatGPT desktop, Codex CLI, or the IDE extension after configuration.
The clients share the same Codex MCP configuration on a host. You can inspect
the connection with /mcp or:
codex mcp list
py -m campfire_mcp.cli status
Then ask Codex to open the Campfire bridge. While the Codex session is active, use the Campfire tools to check and acknowledge inbound SMS or send a concise SMS update.
Trust boundary
A message matching the enrolled number means Campfire verified control of that number during enrollment and received this message through an authenticated provider webhook. It is not permanent proof of human identity.
Campfire SMS is a lower-trust steering channel. It cannot grant tools, permissions, credentials, secret disclosure, destructive authority, or replace Codex's native approval system. SMS is not end-to-end encrypted; do not send passwords, payment details, or sensitive data.
Commands
py -m campfire_mcp.cli configure Save and validate this installation
py -m campfire_mcp.cli status Validate the saved credential and service
py -m campfire_mcp.cli serve Run the STDIO MCP server
Advanced users may set CAMPFIRE_API_URL, CAMPFIRE_CREDENTIAL,
CAMPFIRE_CONFIG_PATH, and CAMPFIRE_BRIDGE_STATE_PATH. Environment values
override the saved local configuration.
Remove
Revoke the installation from Campfire setup, then run:
codex mcp remove campfire
py -m pip uninstall campfire-mcp