imessage-marketplace
Text Claude from your phone via iMessage
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/njerschow--textme)HTML
<a href="/listings/njerschow--textme"><img src="/api/listings/njerschow--textme/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
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.
<details> <summary>Already have an account? (dashboard method)</summary>
1. Go to [dashboard.sendblue.com](https://dashboard.sendblue.com) 2. **Settings → API Settings** — copy your **API Key** and **API Secret** 3. **Settings → Phone Lines** — copy your **Sendblue phone number**
</details>
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
}| Field | What to put | |-------|-------------| | `sendblue.apiKey` | Your Sendblue API key (from `sendblue show-keys`) | | `sendblue.apiSecret` | Your Sendblue API secret (from `sendblue show-keys`) | | `sendblue.phoneNumber` | The Sendblue number assigned to you (from `sendblue show-keys`) | | `whitelist` | Array of **your personal phone numbers** that can text the bot |
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`
---
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
.claude-plugin/marketplace.json · Manifest · 13 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- {
- "name": "imessage-marketplace",
- "owner": {
- "name": "n"
- },
- "plugins": [
- {
- "name": "imessage",
- "source": "./",
- "description": "Send and receive iMessages via Claude Code using Sendblue"
- }
- ]
- }
README.md · README · 199 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- # 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](https://sendblue.com) + [Claude Code](https://docs.anthropic.com/en/docs/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
- ```bash
- 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:
- ```bash
- sendblue setup
- ```
- This creates your account, assigns a phone number, and guides you through verifying your first contact. When done, print your credentials:
- ```bash
- sendblue show-keys
- ```
- Copy the **API Key**, **API Secret**, and **phone number** — you'll need them in the next step.
- <details>
- <summary>Already have an account? (dashboard method)</summary>
- 1. Go to [dashboard.sendblue.com](https://dashboard.sendblue.com)
- 2. **Settings → API Settings** — copy your **API Key** and **API Secret**
- 3. **Settings → Phone Lines** — copy your **Sendblue phone number**
- </details>
- ### 3. Install
- ```bash
- git clone https://github.com/njerschow/textme.git
- cd textme/daemon && npm install && npm run build
- ```
- ### 4. Configure
- ```bash
- mkdir -p ~/.config/claude-imessage
- nano ~/.config/claude-imessage/config.json
- ```
- ```json
- {
- "sendblue": {
- "apiKey": "YOUR_API_KEY",
- "apiSecret": "YOUR_API_SECRET",
- "phoneNumber": "+1SENDBLUE_NUMBER"
- },
- "whitelist": ["+1YOUR_PHONE"],
- "pollIntervalMs": 5000,
- "conversationWindowSize": 20
- }
- ```
- | Field | What to put |
- |-------|-------------|
- | `sendblue.apiKey` | Your Sendblue API key (from `sendblue show-keys`) |
- | `sendblue.apiSecret` | Your Sendblue API secret (from `sendblue show-keys`) |
- | `sendblue.phoneNumber` | The Sendblue number assigned to you (from `sendblue show-keys`) |
- | `whitelist` | Array of **your personal phone numbers** that can text the bot |
- ### 5. Voice Notes (Optional)
- To enable voice memo transcription, add your OpenAI API key (run from inside `textme/daemon/`):
- ```bash
- echo "OPENAI_API_KEY=sk-your-key-here" > .env
- ```
- ### 6. Run
- From inside `textme/daemon/`:
- ```bash
- 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:
- ```bash
- 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](https://docs.sendblue.com/mcp/) 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)
- ```bash
- 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
- ```bash
- # PM2
- pm2 logs textme
- # Standalone
- tail -f ~/.local/log/claude-imessage.log
- ```
- ---
- ## Auto-Start (launchd)
- ```bash
- ./scripts/install-launchd.sh # Enable
- ./scripts/uninstall-launchd.sh # Disable
- ```
- ---
- ## Uninstall
- ```bash
- pm2 delete textme # or: pkill -f "node.*daemon/dist"
- rm -rf ~/.config/claude-imessage ~/.local/log/claude-imessage.log
- ```
- ---
- Built with [Sendblue](https://sendblue.com/cli) + [Claude Code](https://claude.ai/code)
- MIT License
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.