Forward SMS codes from your phone to your scripts and AI agents

Add the MCP server to Claude Code, Claude Desktop, Cursor or any MCP client. When a login asks for a code, the agent calls wait_for_code instead of asking you.

claude mcp add --transport http sms-forwarder https://api.smsforwarder.app/mcp \
  --header "Authorization: Bearer sk_your_key"

{
  "mcpServers": {
    "sms-forwarder": {
      "type": "http",
      "url": "https://api.smsforwarder.app/mcp",
      "headers": { "Authorization": "Bearer sk_your_key" }
    }
  }
}

Prefer skills to MCP? Drop the skill file into your agent's skills folder and set SMSFORWARDER_API_KEY. It teaches the agent when to wait for a code and how.

mkdir -p ~/.claude/skills/sms-forwarder
curl -o ~/.claude/skills/sms-forwarder/SKILL.md https://smsforwarder.app/skill.md

Wait for the next code and print only the code, so it drops straight into a shell script. Exits with status 2 if nothing arrives in time.

npm install -g smsforwarder
smsforwarder login sk_your_key
CODE=$(smsforwarder code --timeout 90)

The wait call holds the connection open until the next code arrives (up to 120 seconds), so there's no polling loop to write.

curl -G https://api.smsforwarder.app/v1/codes/wait \
  -H "Authorization: Bearer sk_your_key" \
  -d timeout=60

{"code":"731942","message":{"service":"Amazon","from":"+1 262-…","body":"…","source":"sms",…}}

Get every new message pushed to your URL as JSON, signed with HMAC-SHA256 so you can check it came from us. Set it from the app or the API. Paste a Slack, Discord or Telegram bot URL instead and each message arrives as a chat message, code first.

curl -X PUT https://api.smsforwarder.app/v1/webhook \
  -H "Authorization: Bearer sk_your_key" \
  -d '{"url":"https://example.com/sms"}'