TextMe

Your personal Claude AI, accessible via iMessage.

Text Claude from anywhere. Send messages, voice notes, or images — get intelligent responses back to your phone. Built on Sendblue + Claude Code.

Features

• Text Claude - Natural conversation via iMessage
• Voice Notes - Send audio, automatically transcribed via OpenAI Whisper
• Images - Send photos, Claude can see and analyze them
• File Access - Claude has full filesystem access for coding tasks
• Attachments - Claude can send files back to you
• Crash Alerts - Get notified if the daemon goes down
• Queue System - Multiple messages processed in order

Quick Start

1. Requirements

brew install node                           # Node.js 18+
npm install -g @sendblue/cli               # Sendblue CLI
npm install -g @anthropic-ai/claude-code   # Claude Code

2. Get Your Sendblue Credentials

Run the Sendblue setup wizard:

sendblue setup

This creates your account, assigns a phone number, and guides you through verifying your first contact. When done, print your credentials:

sendblue show-keys

Copy the API Key, API Secret, and phone number — you'll need them in the next step.

3. Install

git clone https://github.com/njerschow/textme.git
cd textme/daemon && npm install && npm run build

4. Configure

mkdir -p ~/.config/claude-imessage
nano ~/.config/claude-imessage/config.json

{
  "sendblue": {
    "apiKey": "YOUR_API_KEY",
    "apiSecret": "YOUR_API_SECRET",
    "phoneNumber": "+1SENDBLUE_NUMBER"
  },
  "whitelist": ["+1YOUR_PHONE"],
  "pollIntervalMs": 5000,
  "conversationWindowSize": 20
}

5. Voice Notes (Optional)

To enable voice memo transcription, add your OpenAI API key (run from inside textme/daemon/):

echo "OPENAI_API_KEY=sk-your-key-here" > .env

6. Run

From inside textme/daemon/:

npm start

7. Test

Text your Sendblue number from your phone: hello

Want iMessage in Claude Code Instead?

If you want Claude Code to send/receive iMessages directly from your terminal (without running a persistent daemon), add the Sendblue MCP server:

claude mcp add sendblue_api \
  --env SENDBLUE_API_API_KEY=your-api-key \
  --env SENDBLUE_API_API_SECRET=your-api-secret \
  -- npx -y sendblue-api-mcp --client=claude-code --tools=all

This gives Claude Code tools to send iMessages, check number types, manage group chats, and more — all from within your coding session. See Sendblue MCP docs for details.

Commands

Production (PM2)

pm2 start dist/index.js --name textme
pm2 save
pm2 startup

Architecture

daemon/
├── src/
│   ├── index.ts      # Main loop, message processing, media handling
│   ├── sendblue.ts   # Sendblue API (send, receive, upload files)
│   └── ...
├── dist/             # Compiled output
└── package.json

Logs

# PM2
pm2 logs textme

# Standalone
tail -f ~/.local/log/claude-imessage.log

Auto-Start (launchd)

./scripts/install-launchd.sh    # Enable
./scripts/uninstall-launchd.sh  # Disable

Uninstall

pm2 delete textme  # or: pkill -f "node.*daemon/dist"
rm -rf ~/.config/claude-imessage ~/.local/log/claude-imessage.log

Built with Sendblue + Claude Code

MIT License

{
  "name": "imessage-marketplace",
  "owner": {
    "name": "n"
  },
  "plugins": [
    {
      "name": "imessage",
      "source": "./",
      "description": "Send and receive iMessages via Claude Code using Sendblue"
    }
  ]
}