claude-channel-signal

> Note: This has only been tested on Windows. If you're on macOS or Linux, testing and PRs with fixes are very welcome.

Talk to Claude Code from your phone via Signal. Send a Note to Self message, and it arrives in your Claude Code session. Claude can reply back.

signal-cli links as a secondary device on your Signal number. When you send a Note to Self, the message syncs to signal-cli, which forwards it to Claude Code as a channel event. Claude's replies come back through Signal.

• Java 25+ — Adoptium / brew install openjdk / apt install openjdk-25-jre-headless
• Node.js 21+
• Signal on your phone

git clone <repo-url>
cd signal-channel
npm install
npm run setup

The setup script will:

1. Check for Java 25+
2. Download and install signal-cli (if not already installed)
3. Open a QR code in your browser — scan it with Signal to link your device
4. Add the MCP server config to ~/.claude.json
5. Install slash commands globally

Then start Claude Code with the channel:

claude --dangerously-load-development-channels server:signal

Send a Note to Self on Signal. Claude sees it and replies.

After setup, these are available in any Claude Code session:

| Command | Description | |---|---| | /signal:send <message> | Send a message to your phone via Signal | | /signal:access | View and manage the sender allowlist | | /signal:access pair <code> | Approve a sender's pairing code | | /signal:access policy allowlist | Lock down to approved senders only | | /signal:uninstall | Remove everything cleanly |

Environment variables (set in the env block of your MCP config in ~/.claude.json):

| Variable | Description | Default | |---|---|---| | SIGNAL_ACCOUNT | Your phone number (required) | — | | SIGNAL_CLI_PATH | Path to signal-cli binary | `signa