# AgentPhone (MCP server)

> AgentPhone is an MCP server that adds messaging tools to AI assistants such as Claude Desktop, Claude Code and Cursor. Give AI agents real phone numbers, messages, and voice calls via MCP. It has 124 GitHub stars, is released under the MIT license and runs locally with npx -y agentphone-mcp.

Give AI agents real phone numbers, SMS, and voice calls via the Model Context Protocol. AgentPhone lets your AI agent buy phone numbers, send/receive SMS, and place voice calls — all through natural language in Cursor, Claude Desktop, or any MCP-compatible client.

## Key facts

| Fact | Value |
|---|---|
| Repository | https://github.com/AgentPhone-AI/agentphone-mcp |
| GitHub stars | 124 |
| License | MIT |
| Language | TypeScript |
| Transport | stdio, streamable-http |
| Packages | npm: agentphone-mcp |
| Remote URL | https://mcp.agentphone.ai/mcp |
| Needs API key | yes |
| Official | no |
| Works with | Claude Desktop, Claude Code, Cursor, VS Code, Claude.ai, ChatGPT |
| Category | Communication |
| Latest release | none |
| Last commit | Oct 6, 2026 |
| MCP registry name | io.github.AgentPhone-AI/agentphone |

## Install

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "agentphone": {
      "command": "npx",
      "args": [
        "-y",
        "agentphone-mcp"
      ],
      "env": {
        "AGENTPHONE_API_KEY": "your-value"
      }
    }
  }
}
```

Settings > Developer > Edit Config. macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\. Restart Claude Desktop afterwards.

### Claude Code

```sh
claude mcp add --env AGENTPHONE_API_KEY=your-value --transport stdio agentphone -- npx -y agentphone-mcp
```

### Cursor (.cursor/mcp.json)

```json
{
  "mcpServers": {
    "agentphone": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "agentphone-mcp"
      ],
      "env": {
        "AGENTPHONE_API_KEY": "your-value"
      }
    }
  }
}
```

Project file; use ~/.cursor/mcp.json to enable it in every project.

### VS Code (.vscode/mcp.json)

```json
{
  "inputs": [
    {
      "type": "promptString",
      "id": "agentphone_api_key",
      "description": "AGENTPHONE_API_KEY",
      "password": true
    }
  ],
  "servers": {
    "agentphone": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "agentphone-mcp"
      ],
      "env": {
        "AGENTPHONE_API_KEY": "${input:agentphone_api_key}"
      }
    }
  }
}
```

### Claude Code (remote)

```sh
claude mcp add --transport http agentphone "https://mcp.agentphone.ai/mcp"
```

The same server is also hosted as a remote MCP endpoint, so nothing runs on your machine.

Config formats checked against the official docs on 2026-10-07.

## Environment variables

- `AGENTPHONE_API_KEY` (secret) (required): Your AgentPhone API key. Get one at https://agentphone.ai

## Similar MCP servers

- [Strata](https://appsgit.com/mcp-servers/strata): MCP server for progressive tool usage at any scale (see https://klavis.ai). (5,807 stars, Apache-2.0, official)
- [Vexa](https://appsgit.com/mcp-servers/vexa): Meeting bot and transcripts for Google Meet, Teams and Zoom. (2,856 stars, Apache-2.0, official, needs API key)
- [MCP Server for WinDbg Crash Analysis](https://appsgit.com/mcp-servers/mcp-server-for-windbg-crash-analysis): A Model Context Protocol server for Windows crash dump analysis using WinDbg/CDB. (1,607 stars, MIT)
- [Rocketmq Rust](https://appsgit.com/mcp-servers/rocketmq-rust): 🚀 Apache RocketMQ built in Rust 🦀 — faster, safer, and more memory-efficient. (1,524 stars, Apache-2.0)
- [Wassette](https://appsgit.com/mcp-servers/wassette): Wassette: A security-oriented runtime that runs WebAssembly Components via MCP. (957 stars, MIT, official)
- [Line Bot MCP Server](https://appsgit.com/mcp-servers/line-bot-mcp-server): MCP server that integrates the LINE Messaging API to connect an AI Agent to the LINE Official Account. (783 stars, Apache-2.0, official, needs API key)

---

Canonical page: https://appsgit.com/mcp-servers/agentphone
Source: appsgit (https://appsgit.com), the app store for github. Data from the GitHub API, refreshed nightly.
Machine access: JSON API https://appsgit.com/api/v1/apps (OpenAPI: https://appsgit.com/openapi.json), MCP server https://mcp.appsgit.com/mcp, full index https://appsgit.com/llms-full.txt.