Google ADK

Give your Google ADK agent a real phone number. Make calls, receive calls, send and read SMS — all through the AgentPhone MCP server.

Setup

ADK supports MCP servers natively. Choose between running the server locally or connecting to the hosted remote endpoint.

1
from google.adk.agents import Agent
2
from google.adk.tools.mcp_tool import McpToolset
3
from google.adk.tools.mcp_tool.mcp_session_manager import StdioConnectionParams
4
from mcp import StdioServerParameters
5
6
AGENTPHONE_API_KEY = "YOUR_AGENTPHONE_API_KEY"
7
8
root_agent = Agent(
9
    model="gemini-2.5-pro",
10
    name="agentphone_agent",
11
    instruction="Help users make phone calls, send SMS, and manage phone numbers",
12
    tools=[
13
        McpToolset(
14
            connection_params=StdioConnectionParams(
15
                server_params=StdioServerParameters(
16
                    command="npx",
17
                    args=[
18
                        "-y",
19
                        "agentphone-mcp",
20
                    ],
21
                    env={
22
                        "AGENTPHONE_API_KEY": AGENTPHONE_API_KEY,
23
                    }
24
                ),
25
                timeout=30,
26
            ),
27
        )
28
    ],
29
)

Use cases

• Autonomous phone calls — have your agent call a number and hold a full AI conversation about a topic, returning the transcript when done
• SMS messaging — send and receive texts, manage conversation threads across multiple numbers
• Phone number management — provision numbers with specific area codes, assign them to agents
• AI voice agents — create agents with configurable voices, system prompts, and model tiers that handle calls autonomously
• Call transfer and voicemail — configure agents to transfer calls to a human and set up voicemail greetings
• Webhook integration — set up project-level or per-agent webhooks for real-time call and message events

What your agent can do

Once connected, your ADK agent has access to all 26 AgentPhone tools:

Resources

• Full integration guide on ADK docs
• AgentPhone MCP Server on GitHub
• agentphone-mcp on npm
• API Reference