imessage-marketplace

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. Sendblue Setup (Free)

1. Go to sendblue.com/api and sign up
2. Verify your phone number in the dashboard
3. Copy your API Key, API Secret, and Sendblue phone number from Settings

2. Install Requirements

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

3. Clone & Configure

git clone https://github.com/njerschow/textme.git
cd textme

# Create config
mkdir -p ~/.config/claude-imessage
cat > ~/.config/claude-imessage/config.json << 'EOF'
{
  "sendblue": {
    "apiKey": "YOUR_API_KEY",
    "apiSecret": "YOUR_API_SECRET",
    "phoneNumber": "+1SENDBLUE_NUMBER"
  },
  "whitelist": ["+1YOUR_PHONE"],
  "pollIntervalMs": 5000,
  "conversationWindowSize": 20
}
EOF

4. Voice Notes (Optional)

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

5. Build & Run

cd daemon && npm install && npm run build
npm start

6. Test

Text your Sendblue number: 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

Command	Action
?	Show commands
status	Current status & directory
queue	View queued messages
history	Recent messages
home	Go to home directory
reset	Home + clear history
cd /path	Change directory
stop	Cancel current task
yes / no	Approve/reject actions

---

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

MIT License