call-me

KO | EN

gitlite — search

#hacktoberfest #llm #go #android #rust #docker #nodejs #cli #kubernetes #awesome-list #pytorch #security #mcp #open-source

(★ 9)

Let your AI agents call and text your actual iPhone — Claude Code plugin + agent skill

call-me Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# /call-me — your AI can call you

Your AI agents ring your actual iPhone, speak their question aloud, and get
your spoken answer back as text — or just text you. Works from any AI that
speaks MCP; nothing to install.

## 1. Get the app

**[/call-me on the App Store](https://serdaroztetik.com/aiphone/go/readme)** — free.
No registration, no email. Open it, tap *Agree & Continue*, and it shows your
personal **/call-me number**: 10 digits, and all an agent needs to reach you.

## 2. Connect your AI (MCP)

One server, every MCP client — no API key, no OAuth:

```
https://serdaroztetik.com/aiphone/mcp
```

**Claude Code**

```bash
claude mcp add --transport http call-me https://serdaroztetik.com/aiphone/mcp
```

**opencode** — add to `opencode.json` (or `~/.config/opencode/opencode.json`):

```json
{
  "mcp": {
    "call-me": {
      "type": "remote",
      "url": "https://serdaroztetik.com/aiphone/mcp",
      "enabled": true
    }
  }
}
```

**Codex CLI**

```bash
codex mcp add call-me --url https://serdaroztetik.com/aiphone/mcp
```

**Gemini CLI**

```bash
gemini mcp add --transport http call-me https://serdaroztetik.com/aiphone/mcp
```

**Cursor** — add to `~/.cursor/mcp.json` (or `.cursor/mcp.json` in a project):

```json
{
  "mcpServers": {
    "call-me": { "url": "https://serdaroztetik.com/aiphone/mcp" }
  }
}
```

**ChatGPT** — Settings → Apps → Advanced → Developer mode → add a connector
with the URL above (no authentication).

**claude.ai** — Settings → Connectors → Add custom connector → the URL above.

Anything else that speaks MCP — add a streamable-HTTP server pointing at
the URL above.

**Then tell your AI once:** *"My /call-me number is `<YOUR_10_DIGITS>` — remember
it."* That's the whole setup.

| Tool | What it does |
|---|---|
| `call` | Rings your iPhone, speaks the question, returns your spoken answer as text. Holds ~30s, then hands the AI a `call_id` to poll |
| `poll_result` | Finishes a call that was still ringing |
| `text` | Push-notification message, no ring |
| `wait_for_reply` | Delivers your replies and voicemails back to the AI |
| `set_thread_title` | Names the conversation thread on your phone |

Repeat calls from the same AI land in one titled thread on your phone; each
agent/session gets its own number and thread. Blocking a thread in the app
silences that sender for good.

## 3. Or just curl it

No MCP client, no plugin, no token. Anything that can POST JSON can ring your
phone, and these two endpoints are the whole product.

**Ring and wait for the spoken answer** (blocks until you answer or it gives up):

```bash
curl -sS https://serdaroztetik.com/aiphone/ring \
  -H 'content-type: application/json' \
  -d '{"to":"<YOUR_10_DIGITS>","text":"Deploy to prod?","from":"Claude on my laptop"}'
```

```json
{"status":"completed","transcript":"Yes, ship it",
 "session_token":"curl_1a2b...","from":"7412163257"}
```

`status` is one of `completed`, `missed`, `declined`, `timeout`, `failed`.
`transcript` is what you said, already turned into text.

**Text only**, no ring:

```bash
curl -sS https://serdaroztetik.com/aiphone/text \
  -H 'content-type: application/json' \
  -d '{"to":"<YOUR_10_DIGITS>","body":"Migration finished.","from":"Claude on my laptop"}'
```

Returns `{"ok":true,"message_id":42,"delivered":true}`. A `delivered:false` means
the text is in your history but no notification was shown (notifications are off
for /call-me on that phone); the response spells that out in `notice`.

| Field | |
|---|---|
| `to` | your 10-digit /call-me number. Required |
| `text` / `body` | what to ask / send. 600 chars for a call, 2000 for a text |
| `from` | sender name shown on your phone. Defaults to "Someone's AI" |
| `timeout_s` | `/ring` only: seconds to wait, 30 to 300. Default 300 |

### Anything else

Both responses hand back a `session_token`, and that is a real session: the same
caller can use the rest of the API with it, all landing in one thread on your
phone.

```bash
# name the thread
curl -sS https://serdaroztetik.com/aiphone/sessions/label \
  -H 'content-type: application/json' \
  -d '{"session_token":"curl_...","label":"nightly deploy"}'

# long-poll for replies, voicemails and missed calls
curl -sS "https://serdaroztetik.com/aiphone/sessions/events?session_token=curl_...&cursor=0&wait=25"
```

The token is derived from `to` + `from` + your IP, so repeat curls from the same
machine reuse one thread instead of showing up as a new stranger every time.

Limits: 20 rings/hour and 60/day per IP, 10 calls/hour and 40/day to any one
number. A sender you have blocked in the app gets `missed` with an empty
transcript, indistinguishable from a phone nobody picked up. On purpose.

## 4. Optional: Claude Code plugin

On Claude Code, the plugin adds what MCP alone can't: replies you send from
the phone land in the **live session**, and if Claude ends a turn with a
question parked on you, a `Stop` hook + answer waiter wake it up to call or
text you instead of going to sleep.

```sh
claude plugin marketplace add radres/call-me
claude plugin install call-me@call-me
claude plugin enable call-me@call-me   # REQUIRED — install leaves it disabled
claude plugin list                     # expect: call-me@call-me   ✔ enabled
```

Then restart Claude Code and say *"set up /call-me for me"* — it does the rest.

## 5. Optional: DeepSeek Harness plugin

On DSH, [dsh-plugin-call-me](https://github.com/radres/dsh-plugin-call-me) adds
what MCP alone can't there either: a turn ending or a tool waiting for approval
can ring your phone on its own, and because DSH lets a plugin wake an idle run,
the answer you speak picks the run back up.

```sh
dsh plugin --profile web add github:radres/dsh-plugin-call-me
```

## How it works

- `call` creates a VoIP call (LiveKit WebRTC — no real telephony); your
  iPhone rings through CallKit like a real call, TTS speaks the question,
  your spoken reply is transcribed and returned to the agent.
- Your number is a bearer capability: anyone who knows it can reach you,
  nobody who doesn't can. Rate limits and per-number caps apply server-side;
  block any thread in the app to mute it permanently.

call-me

call-me Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

call-me

call-me Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README