Skip to content
Back to search

imessage-marketplace

MarketplaceWorks with Claude CodeGitHub

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.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/njerschow--textme/badge.svg)](/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)

  1. {
  2. "name": "imessage-marketplace",
  3. "owner": {
  4. "name": "n"
  5. },
  6. "plugins": [
  7. {
  8. "name": "imessage",
  9. "source": "./",
  10. "description": "Send and receive iMessages via Claude Code using Sendblue"
  11. }
  12. ]
  13. }
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)

  1. # TextMe
  2. **Your personal Claude AI, accessible via iMessage.**
  3. 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).
  4. ---
  5. ## Features
  6. - **Text Claude** - Natural conversation via iMessage
  7. - **Voice Notes** - Send audio, automatically transcribed via OpenAI Whisper
  8. - **Images** - Send photos, Claude can see and analyze them
  9. - **File Access** - Claude has full filesystem access for coding tasks
  10. - **Attachments** - Claude can send files back to you
  11. - **Crash Alerts** - Get notified if the daemon goes down
  12. - **Queue System** - Multiple messages processed in order
  13. ---
  14. ## Quick Start
  15. ### 1. Requirements
  16. ```bash
  17. brew install node # Node.js 18+
  18. npm install -g @sendblue/cli # Sendblue CLI
  19. npm install -g @anthropic-ai/claude-code # Claude Code
  20. ```
  21. ### 2. Get Your Sendblue Credentials
  22. Run the Sendblue setup wizard:
  23. ```bash
  24. sendblue setup
  25. ```
  26. This creates your account, assigns a phone number, and guides you through verifying your first contact. When done, print your credentials:
  27. ```bash
  28. sendblue show-keys
  29. ```
  30. Copy the **API Key**, **API Secret**, and **phone number** — you'll need them in the next step.
  31. <details>
  32. <summary>Already have an account? (dashboard method)</summary>
  33. 1. Go to [dashboard.sendblue.com](https://dashboard.sendblue.com)
  34. 2. **Settings → API Settings** — copy your **API Key** and **API Secret**
  35. 3. **Settings → Phone Lines** — copy your **Sendblue phone number**
  36. </details>
  37. ### 3. Install
  38. ```bash
  39. git clone https://github.com/njerschow/textme.git
  40. cd textme/daemon && npm install && npm run build
  41. ```
  42. ### 4. Configure
  43. ```bash
  44. mkdir -p ~/.config/claude-imessage
  45. nano ~/.config/claude-imessage/config.json
  46. ```
  47. ```json
  48. {
  49. "sendblue": {
  50. "apiKey": "YOUR_API_KEY",
  51. "apiSecret": "YOUR_API_SECRET",
  52. "phoneNumber": "+1SENDBLUE_NUMBER"
  53. },
  54. "whitelist": ["+1YOUR_PHONE"],
  55. "pollIntervalMs": 5000,
  56. "conversationWindowSize": 20
  57. }
  58. ```
  59. | Field | What to put |
  60. |-------|-------------|
  61. | `sendblue.apiKey` | Your Sendblue API key (from `sendblue show-keys`) |
  62. | `sendblue.apiSecret` | Your Sendblue API secret (from `sendblue show-keys`) |
  63. | `sendblue.phoneNumber` | The Sendblue number assigned to you (from `sendblue show-keys`) |
  64. | `whitelist` | Array of **your personal phone numbers** that can text the bot |
  65. ### 5. Voice Notes (Optional)
  66. To enable voice memo transcription, add your OpenAI API key (run from inside `textme/daemon/`):
  67. ```bash
  68. echo "OPENAI_API_KEY=sk-your-key-here" > .env
  69. ```
  70. ### 6. Run
  71. From inside `textme/daemon/`:
  72. ```bash
  73. npm start
  74. ```
  75. ### 7. Test
  76. Text your Sendblue number from your phone: `hello`
  77. ---
  78. ## Want iMessage in Claude Code Instead?
  79. If you want Claude Code to send/receive iMessages directly from your terminal (without running a persistent daemon), add the Sendblue MCP server:
  80. ```bash
  81. claude mcp add sendblue_api \
  82. --env SENDBLUE_API_API_KEY=your-api-key \
  83. --env SENDBLUE_API_API_SECRET=your-api-secret \
  84. -- npx -y sendblue-api-mcp --client=claude-code --tools=all
  85. ```
  86. 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.
  87. ---
  88. ## Commands
  89. | Command | Action |
  90. |---------|--------|
  91. | `?` | Show commands |
  92. | `status` | Current status & directory |
  93. | `queue` | View queued messages |
  94. | `history` | Recent messages |
  95. | `home` | Go to home directory |
  96. | `reset` | Home + clear history |
  97. | `cd /path` | Change directory |
  98. | `stop` | Cancel current task |
  99. | `yes` / `no` | Approve/reject actions |
  100. ---
  101. ## Production (PM2)
  102. ```bash
  103. pm2 start dist/index.js --name textme
  104. pm2 save
  105. pm2 startup
  106. ```
  107. ---
  108. ## Architecture
  109. ```
  110. daemon/
  111. ├── src/
  112. │ ├── index.ts # Main loop, message processing, media handling
  113. │ ├── sendblue.ts # Sendblue API (send, receive, upload files)
  114. │ └── ...
  115. ├── dist/ # Compiled output
  116. └── package.json
  117. ```
  118. ---
  119. ## Logs
  120. ```bash
  121. # PM2
  122. pm2 logs textme
  123. # Standalone
  124. tail -f ~/.local/log/claude-imessage.log
  125. ```
  126. ---
  127. ## Auto-Start (launchd)
  128. ```bash
  129. ./scripts/install-launchd.sh # Enable
  130. ./scripts/uninstall-launchd.sh # Disable
  131. ```
  132. ---
  133. ## Uninstall
  134. ```bash
  135. pm2 delete textme # or: pkill -f "node.*daemon/dist"
  136. rm -rf ~/.config/claude-imessage ~/.local/log/claude-imessage.log
  137. ```
  138. ---
  139. Built with [Sendblue](https://sendblue.com/cli) + [Claude Code](https://claude.ai/code)
  140. MIT License

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.