Give AI agents real phone numbers, messages, and voice calls via MCP.
Setup
Choose your client, copy the config, then fill in any required environment variables.
Local
claude mcp add agentphone --env AGENTPHONE_API_KEY='<AGENTPHONE_API_KEY>' -- npx -y agentphone-mcp~/.codex/config.toml
[mcp_servers.agentphone]
command = "npx"
args = ["-y", "agentphone-mcp"]
env = { AGENTPHONE_API_KEY = "<AGENTPHONE_API_KEY>" }
# codex mcp add agentphone --env AGENTPHONE_API_KEY='<AGENTPHONE_API_KEY>' -- npx -y agentphone-mcp~/.cursor/mcp.json
{
"mcpServers": {
"agentphone": {
"command": "npx",
"args": [
"-y",
"agentphone-mcp"
],
"env": {
"AGENTPHONE_API_KEY": "<AGENTPHONE_API_KEY>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"agentphone": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"agentphone-mcp"
],
"env": {
"AGENTPHONE_API_KEY": "<AGENTPHONE_API_KEY>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"agentphone": {
"command": "npx",
"args": [
"-y",
"agentphone-mcp"
],
"env": {
"AGENTPHONE_API_KEY": "<AGENTPHONE_API_KEY>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"agentphone": {
"command": "npx",
"args": [
"-y",
"agentphone-mcp"
],
"env": {
"AGENTPHONE_API_KEY": "<AGENTPHONE_API_KEY>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"agentphone": {
"command": "npx",
"args": [
"-y",
"agentphone-mcp"
],
"env": {
"AGENTPHONE_API_KEY": "<AGENTPHONE_API_KEY>"
}
}
}
}Remote
claude mcp add --transport http agentphone https://mcp.agentphone.ai/mcp --header 'Authorization: <AUTHORIZATION>'~/.codex/config.toml
[mcp_servers.agentphone]
url = "https://mcp.agentphone.ai/mcp"
http_headers = { Authorization = "<AUTHORIZATION>" }
# codex mcp add agentphone --url https://mcp.agentphone.ai/mcp~/.cursor/mcp.json
{
"mcpServers": {
"agentphone": {
"url": "https://mcp.agentphone.ai/mcp",
"headers": {
"Authorization": "<AUTHORIZATION>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"agentphone": {
"type": "http",
"url": "https://mcp.agentphone.ai/mcp",
"headers": {
"Authorization": "<AUTHORIZATION>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"agentphone": {
"httpUrl": "https://mcp.agentphone.ai/mcp",
"headers": {
"Authorization": "<AUTHORIZATION>"
}
}
}
}claude_desktop_config.json · Customize › Connectors › Add custom connector
{
"mcpServers": {
"agentphone": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://mcp.agentphone.ai/mcp",
"--header",
"Authorization:<AUTHORIZATION>"
]
}
}
}.trae/mcp.json
{
"mcpServers": {
"agentphone": {
"url": "https://mcp.agentphone.ai/mcp",
"headers": {
"Authorization": "<AUTHORIZATION>"
}
}
}
}Environment variables
AGENTPHONE_API_KEY
Replace the placeholders with your own credentials and keep them out of version control.