Skip to content

CallMeMCP

Your AI agent rings your iPhone, reads its question aloud, and returns your spoken answer as text. Needs the /call-me iPhone app (paid subscription) for the 10-digit number.

build.protocol_tooling.mcp

Install CallMeMCP in your MCP client

CallMeMCP is a Model Context Protocol server. Add it to your MCP client config once, restart, and the server's tools become available to your AI assistant. The same JSON snippet below works across all four major clients — only the config file path differs.

  1. Locate your client's MCP config file.
    • Cursor: ~/.cursor/mcp.json
    • Claude Desktop (macOS): ~/Library/Application Support/Claude/claude_desktop_config.json
    • Claude Desktop (Windows): %APPDATA%\Claude\claude_desktop_config.json
    • VS Code: Settings → Extensions → MCP
    • Windsurf: Settings → MCP Servers
  2. Add CallMeMCP to the mcpServers map — paste the snippet below into your config file. If you already have other MCP servers, merge the entry into the existing mcpServers object.
  3. Restart your client so it picks up the new server.
  4. Verify — ask the assistant to list available tools; CallMeMCP's tools should appear.
{
  "mcpServers": {
    "callmemcp": {
      "command": "npx",
      "args": [
        "-y",
        "@callmemcp/mcp-server"
      ],
      "note": "Replace with the actual package name from the server's documentation."
    }
  }
}

Install CallMeMCP in Cursor

Open ~/.cursor/mcp.json in your editor, paste the snippet above into mcpServers, save, and restart Cursor. CallMeMCP will show up in the assistant's tool list on next launch.

Install CallMeMCP in Claude Desktop (macOS)

Open ~/Library/Application Support/Claude/claude_desktop_config.json in your editor, paste the snippet above into mcpServers, save, and restart Claude Desktop (macOS). CallMeMCP will show up in the assistant's tool list on next launch.

Install CallMeMCP in Claude Desktop (Windows)

Open %APPDATA%\Claude\claude_desktop_config.json in your editor, paste the snippet above into mcpServers, save, and restart Claude Desktop (Windows). CallMeMCP will show up in the assistant's tool list on next launch.

Install CallMeMCP in VS Code

Open Settings → Extensions → MCP in your editor, paste the snippet above into mcpServers, save, and restart VS Code. CallMeMCP will show up in the assistant's tool list on next launch.

Tools exposed by CallMeMCP

Once installed, CallMeMCP exposes the following MCP tools to your AI assistant. Each tool can be called directly by the assistant whenever its capability is relevant to your prompt.

  • setup

    Return first-setup instructions and a clickable App Store download link when no number is available.

  • call

    Ring the human's iPhone, read `question` aloud word for word, and return what they say back. It does not have to be a question: an update or a summary of the day ahead works too, up to 2000 characters (about two minutes of speech). Waits up to ~30s; if the result comes back status "ringing" or "in_call", follow up with poll_result. On a local client, read `to` from `~/.aiphone/config.json` → `user_number`; this hosted server cannot read that file itself. It is a Call Me a

  • poll_result

    Check on a call that was still ringing or in progress. Waits up to ~25s for it to settle; returns the final status and transcript once the call ends, the human declines, or the ring times out ("missed").

  • text

    Send a one-way text to the human's phone (push notification, no ring). On a local client, read `to` from `~/.aiphone/config.json` → `user_number`; this hosted server cannot read that file itself. If missing, returns setup_required with the App Store link. Pass a previous session_token to stay in the same thread.

  • wait_for_reply

    Wait for the human to send something back to this session — texts and voicemail transcripts arrive here. Long-polls up to wait_s (max 30s); returns {events, cursor}. Pass the returned cursor next time to only see new events. An empty events list just means nothing yet — poll again if you are still waiting.

  • set_thread_title

    Name this session's conversation thread on the human's phone (e.g. the project or task you are working on). Shown as the thread title in the app.

Transport

CallMeMCP supports the following MCP transports. Most AI clients use stdio by default for locally-installed servers.

streamable-http

Other Model Context Protocol servers in the same space as CallMeMCP. Each one adds different capabilities to your AI assistant — pick based on the data sources or workflows you need.

Browse the full MCP server directory or use Stork's one-line install to let your agent pick the right server automatically.