Skip to content
Back to search

callme

MarketplaceWorks with Claude CodeGitHub

Minimal plugin that lets Claude Code call you on the phone.

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/zeframlou-call-me/badge.svg)](/listings/zeframlou-call-me)

HTML

<a href="/listings/zeframlou-call-me"><img src="/api/listings/zeframlou-call-me/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. Get Required Accounts

You'll need: - **Phone provider**: [Telnyx](https://telnyx.com) or [Twilio](https://twilio.com) - **OpenAI API key**: For speech-to-text (and text-to-speech if not using Kokoro) - **ngrok account**: Free at [ngrok.com](https://ngrok.com) (for webhook tunneling)

2. Set Up Phone Provider

Choose **one** of the following:

<details> <summary><b>Option A: Telnyx (Recommended - 50% cheaper)</b></summary>

1. Create account at [portal.telnyx.com](https://portal.telnyx.com) and verify your identity 2. [Buy a phone number](https://portal.telnyx.com/#/numbers/buy-numbers) (~$1/month) 3. [Create a Voice API application](https://portal.telnyx.com/#/call-control/applications): - Set webhook URL to `https://your-ngrok-url/twiml` and API version to v2 - You can see your ngrok URL on the ngrok dashboard - Note your **Application ID** and **API Key** 4. [Verify the phone number](https://portal.telnyx.com/#/numbers/verified-numbers) you want to receive calls at 5. (Optional but recommended) Get your **Public Key** from Account Settings > Keys & Credentials for webhook signature verification

**Environment variables for Telnyx:**

CALLME_PHONE_PROVIDER=telnyx
CALLME_PHONE_ACCOUNT_SID=<Application ID>
CALLME_PHONE_AUTH_TOKEN=<API Key>
CALLME_TELNYX_PUBLIC_KEY=<Public Key>  # Optional: enables webhook security

</details>

<details> <summary><b>Option B: Twilio (Not recommended - need to buy $20 of credits just to start and more expensive overall)</b></summary>

1. Create account at [twilio.com/console](https://www.twilio.com/console) 2. Use the free number your account comes with or [buy a new phone number](https://www.twilio.com/console/phone-numbers/incoming) (~$1.15/month) 3. Find your **Account SID** and **Auth Token** on the [Console Dashboard](https://www.twilio.com/console)

**Environment variables for Twilio:**

CALLME_PHONE_PROVIDER=twilio
CALLME_PHONE_ACCOUNT_SID=<Account SID>
CALLME_PHONE_AUTH_TOKEN=<Auth Token>

</details>

3. Set Environment Variables

Add these to `~/.claude/settings.json` (recommended) or export them in your shell:

{
  "env": {
    "CALLME_PHONE_PROVIDER": "telnyx",
    "CALLME_PHONE_ACCOUNT_SID": "your-connection-id-or-account-sid",
    "CALLME_PHONE_AUTH_TOKEN": "your-api-key-or-auth-token",
    "CALLME_PHONE_NUMBER": "+15551234567",
    "CALLME_USER_PHONE_NUMBER": "+15559876543",
    "CALLME_OPENAI_API_KEY": "sk-...",
    "CALLME_NGROK_AUTHTOKEN": "your-ngrok-token"
  }
}

Required Variables

| Variable | Description | |----------|-------------| | `CALLME_PHONE_PROVIDER` | `telnyx` (default) or `twilio` | | `CALLME_PHONE_ACCOUNT_SID` | Telnyx Connection ID or Twilio Account SID | | `CALLME_PHONE_AUTH_TOKEN` | Telnyx API Key or Twilio Auth Token | | `CALLME_PHONE_NUMBER` | Phone number Claude calls from (E.164 format) | | `CALLME_USER_PHONE_NUMBER` | Your phone number to receive calls | | `CALLME_OPENAI_API_KEY` | OpenAI API key (required for STT; also for TTS unless using Kokoro) | | `CALLME_NGROK_AUTHTOKEN` | ngrok auth token for webhook tunneling |

Optional Variables

| Variable | Default | Description | |----------|---------|-------------| | `CALLME_TTS_PROVIDER` | `openai` | TTS engine: `openai` or `kokoro` (free, local — see [Kokoro TTS](#kokoro-tts-free-local)) | | `CALLME_TTS_VOICE` | `onyx` / `af_bella` | Voice name (default depends on TTS provider) | | `CALLME_KOKORO_URL` | - | URL of existing Kokoro instance (e.g. `http://localhost:8880/v1`). If unset, auto-starts Docker container | | `CALLME_PORT` | `0` (auto) | Local HTTP server port (0 = OS picks a free port) | | `CALLME_NGROK_DOMAIN` | - | Custom ngrok domain (paid feature) | | `CALLME_TRANSCRIPT_TIMEOUT_MS` | `180000` | Timeout for user speech (3 minutes) | | `CALLME_STT_SILENCE_DURATION_MS` | `800` | Silence duration to detect end of speech | | `CALLME_TELNYX_PUBLIC_KEY` | - | Telnyx public key for webhook signature verification (recommended) |

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 · 18 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": "callme",
  3. "owner": {
  4. "name": "ZeframLou"
  5. },
  6. "plugins": [
  7. {
  8. "name": "callme",
  9. "description": "Claude calls you on the phone when it needs your input or wants to report progress",
  10. "version": "1.0.3",
  11. "author": {
  12. "name": "ZeframLou",
  13. "url": "https://github.com/ZeframLou"
  14. },
  15. "source": "./"
  16. }
  17. ]
  18. }
README.md · README · 268 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # CallMe
  2. **Minimal plugin that lets Claude Code call you on the phone.**
  3. Start a task, walk away. Your phone/watch rings when Claude is done, stuck, or needs a decision.
  4. <img src="./call-me-comic-min.png" width="800" alt="CallMe comic strip">
  5. - **Minimal plugin** - Does one thing: call you on the phone. No crazy setups.
  6. - **Multi-turn conversations** - Talk through decisions naturally.
  7. - **Works anywhere** - Smartphone, smartwatch, or even landline!
  8. - **Tool-use composable** - Claude can e.g. do a web search while on a call with you.
  9. ---
  10. ## Quick Start
  11. ### 1. Get Required Accounts
  12. You'll need:
  13. - **Phone provider**: [Telnyx](https://telnyx.com) or [Twilio](https://twilio.com)
  14. - **OpenAI API key**: For speech-to-text (and text-to-speech if not using Kokoro)
  15. - **ngrok account**: Free at [ngrok.com](https://ngrok.com) (for webhook tunneling)
  16. ### 2. Set Up Phone Provider
  17. Choose **one** of the following:
  18. <details>
  19. <summary><b>Option A: Telnyx (Recommended - 50% cheaper)</b></summary>
  20. 1. Create account at [portal.telnyx.com](https://portal.telnyx.com) and verify your identity
  21. 2. [Buy a phone number](https://portal.telnyx.com/#/numbers/buy-numbers) (~$1/month)
  22. 3. [Create a Voice API application](https://portal.telnyx.com/#/call-control/applications):
  23. - Set webhook URL to `https://your-ngrok-url/twiml` and API version to v2
  24. - You can see your ngrok URL on the ngrok dashboard
  25. - Note your **Application ID** and **API Key**
  26. 4. [Verify the phone number](https://portal.telnyx.com/#/numbers/verified-numbers) you want to receive calls at
  27. 5. (Optional but recommended) Get your **Public Key** from Account Settings > Keys & Credentials for webhook signature verification
  28. **Environment variables for Telnyx:**
  29. ```bash
  30. CALLME_PHONE_PROVIDER=telnyx
  31. CALLME_PHONE_ACCOUNT_SID=<Application ID>
  32. CALLME_PHONE_AUTH_TOKEN=<API Key>
  33. CALLME_TELNYX_PUBLIC_KEY=<Public Key> # Optional: enables webhook security
  34. ```
  35. </details>
  36. <details>
  37. <summary><b>Option B: Twilio (Not recommended - need to buy $20 of credits just to start and more expensive overall)</b></summary>
  38. 1. Create account at [twilio.com/console](https://www.twilio.com/console)
  39. 2. Use the free number your account comes with or [buy a new phone number](https://www.twilio.com/console/phone-numbers/incoming) (~$1.15/month)
  40. 3. Find your **Account SID** and **Auth Token** on the [Console Dashboard](https://www.twilio.com/console)
  41. **Environment variables for Twilio:**
  42. ```bash
  43. CALLME_PHONE_PROVIDER=twilio
  44. CALLME_PHONE_ACCOUNT_SID=<Account SID>
  45. CALLME_PHONE_AUTH_TOKEN=<Auth Token>
  46. ```
  47. </details>
  48. ### 3. Set Environment Variables
  49. Add these to `~/.claude/settings.json` (recommended) or export them in your shell:
  50. ```json
  51. {
  52. "env": {
  53. "CALLME_PHONE_PROVIDER": "telnyx",
  54. "CALLME_PHONE_ACCOUNT_SID": "your-connection-id-or-account-sid",
  55. "CALLME_PHONE_AUTH_TOKEN": "your-api-key-or-auth-token",
  56. "CALLME_PHONE_NUMBER": "+15551234567",
  57. "CALLME_USER_PHONE_NUMBER": "+15559876543",
  58. "CALLME_OPENAI_API_KEY": "sk-...",
  59. "CALLME_NGROK_AUTHTOKEN": "your-ngrok-token"
  60. }
  61. }
  62. ```
  63. #### Required Variables
  64. | Variable | Description |
  65. |----------|-------------|
  66. | `CALLME_PHONE_PROVIDER` | `telnyx` (default) or `twilio` |
  67. | `CALLME_PHONE_ACCOUNT_SID` | Telnyx Connection ID or Twilio Account SID |
  68. | `CALLME_PHONE_AUTH_TOKEN` | Telnyx API Key or Twilio Auth Token |
  69. | `CALLME_PHONE_NUMBER` | Phone number Claude calls from (E.164 format) |
  70. | `CALLME_USER_PHONE_NUMBER` | Your phone number to receive calls |
  71. | `CALLME_OPENAI_API_KEY` | OpenAI API key (required for STT; also for TTS unless using Kokoro) |
  72. | `CALLME_NGROK_AUTHTOKEN` | ngrok auth token for webhook tunneling |
  73. #### Optional Variables
  74. | Variable | Default | Description |
  75. |----------|---------|-------------|
  76. | `CALLME_TTS_PROVIDER` | `openai` | TTS engine: `openai` or `kokoro` (free, local — see [Kokoro TTS](#kokoro-tts-free-local)) |
  77. | `CALLME_TTS_VOICE` | `onyx` / `af_bella` | Voice name (default depends on TTS provider) |
  78. | `CALLME_KOKORO_URL` | - | URL of existing Kokoro instance (e.g. `http://localhost:8880/v1`). If unset, auto-starts Docker container |
  79. | `CALLME_PORT` | `0` (auto) | Local HTTP server port (0 = OS picks a free port) |
  80. | `CALLME_NGROK_DOMAIN` | - | Custom ngrok domain (paid feature) |
  81. | `CALLME_TRANSCRIPT_TIMEOUT_MS` | `180000` | Timeout for user speech (3 minutes) |
  82. | `CALLME_STT_SILENCE_DURATION_MS` | `800` | Silence duration to detect end of speech |
  83. | `CALLME_TELNYX_PUBLIC_KEY` | - | Telnyx public key for webhook signature verification (recommended) |
  84. ### 4. Install Plugin
  85. ```bash
  86. /plugin marketplace add ZeframLou/call-me
  87. /plugin install callme@callme
  88. ```
  89. Restart Claude Code. Done!
  90. ---
  91. ## How It Works
  92. ```
  93. Claude Code CallMe MCP Server (local)
  94. │ │
  95. │ "I finished the feature..." │
  96. ▼ ▼
  97. Plugin ────stdio──────────────────► MCP Server
  98. │
  99. ├─► ngrok tunnel
  100. │
  101. ▼
  102. Phone Provider (Telnyx/Twilio)
  103. │
  104. ▼
  105. Your Phone rings
  106. You speak
  107. Text returns to Claude
  108. ```
  109. The MCP server runs locally and automatically creates an ngrok tunnel for phone provider webhooks.
  110. ---
  111. ## Tools
  112. ### `initiate_call`
  113. Start a phone call.
  114. ```typescript
  115. const { callId, response } = await initiate_call({
  116. message: "Hey! I finished the auth system. What should I work on next?"
  117. });
  118. ```
  119. ### `continue_call`
  120. Continue with follow-up questions.
  121. ```typescript
  122. const response = await continue_call({
  123. call_id: callId,
  124. message: "Got it. Should I add rate limiting too?"
  125. });
  126. ```
  127. ### `speak_to_user`
  128. Speak to the user without waiting for a response. Useful for acknowledging requests before time-consuming operations.
  129. ```typescript
  130. await speak_to_user({
  131. call_id: callId,
  132. message: "Let me search for that information. Give me a moment..."
  133. });
  134. // Continue with your long-running task
  135. const results = await performSearch();
  136. // Then continue the conversation
  137. const response = await continue_call({
  138. call_id: callId,
  139. message: `I found ${results.length} results...`
  140. });
  141. ```
  142. ### `end_call`
  143. End the call.
  144. ```typescript
  145. await end_call({
  146. call_id: callId,
  147. message: "Perfect, I'll get started. Talk soon!"
  148. });
  149. ```
  150. ---
  151. ## Costs
  152. | Service | Telnyx | Twilio |
  153. |---------|--------|--------|
  154. | Outbound calls | ~$0.007/min | ~$0.014/min |
  155. | Phone number | ~$1/month | ~$1.15/month |
  156. Plus API costs (same for both phone providers):
  157. - **Speech-to-text**: ~$0.006/min (OpenAI gpt-4o-transcribe)
  158. - **Text-to-speech**: ~$0.02/min (OpenAI TTS) or **free** with Kokoro
  159. **Total**: ~$0.03-0.04/minute with OpenAI TTS, ~$0.01-0.02/minute with Kokoro
  160. ---
  161. ## Kokoro TTS (Free, Local)
  162. [Kokoro](https://github.com/remsky/Kokoro-FastAPI) is a free, local text-to-speech engine that runs via Docker. No TTS API key needed — just set one env var (note: `CALLME_OPENAI_API_KEY` is still required if you use the OpenAI API for speech-to-text):
  163. ```bash
  164. CALLME_TTS_PROVIDER=kokoro
  165. ```
  166. **Auto-setup:** If Docker is installed and port 8880 is free, the plugin automatically pulls and starts the Kokoro container on first use.
  167. **Existing instance:** If you already have Kokoro running (or want a custom port), point to it:
  168. ```bash
  169. CALLME_TTS_PROVIDER=kokoro
  170. CALLME_KOKORO_URL=http://localhost:8880/v1
  171. ```
  172. **Voices:** Kokoro has different voices than OpenAI. Query available voices at `http://localhost:8880/v1/audio/voices`. Popular choices: `af_bella`, `af_sky`, `am_adam`. Set with `CALLME_TTS_VOICE`.
  173. **Requirements:** Docker (for auto-setup) or an existing Kokoro instance.
  174. ---
  175. ## Troubleshooting
  176. ### Claude doesn't use the tool
  177. 1. Check all required environment variables are set (ideally in `~/.claude/settings.json`)
  178. 2. Restart Claude Code after installing the plugin
  179. 3. Try explicitly: "Call me to discuss the next steps when you're done."
  180. ### Call doesn't connect
  181. 1. Check the MCP server logs (stderr) with `claude --debug`
  182. 2. Verify your phone provider credentials are correct
  183. 3. Make sure ngrok can create a tunnel
  184. ### Audio issues
  185. 1. Ensure your phone number is verified with your provider
  186. 2. Check that the webhook URL in your provider dashboard matches your ngrok URL
  187. ### ngrok errors
  188. 1. Verify your `CALLME_NGROK_AUTHTOKEN` is correct
  189. 2. Check if you've hit ngrok's free tier limits
  190. 3. Try a different port with `CALLME_PORT=3334`
  191. ---
  192. ## Development
  193. ```bash
  194. cd server
  195. bun install
  196. bun run dev
  197. ```
  198. ---
  199. ## License
  200. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

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