Skip to navigation

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.

Get your API key from Settings, install google-adk for Python or @google/adk for TypeScript, and configure credentials for your chosen model. The local transport also needs Node and npx. MCP actions and hosted voice do not need your own webhook server; real-time custom inbound handling does.

Setup

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

from google.adk.agents import Agent
from google.adk.tools.mcp_tool import McpToolset
from google.adk.tools.mcp_tool.mcp_session_manager import StdioConnectionParams
from mcp import StdioServerParameters
AGENTPHONE_API_KEY = "YOUR_AGENTPHONE_API_KEY"
root_agent = Agent(
    model="gemini-2.5-pro",
    name="agentphone_agent",
    instruction="Help users make phone calls, send SMS, and manage phone numbers",
    tools=[
        McpToolset(
            connection_params=StdioConnectionParams(
                server_params=StdioServerParameters(
                    command="npx",
                    args=[
                        "-y",
                        "agentphone-mcp",
                    ],
                    env={
                        "AGENTPHONE_API_KEY": AGENTPHONE_API_KEY,
                    }
                ),
                timeout=30,
            ),
        )
    ],
)

Use cases

  • Autonomous phone calls — have your agent call a number and hold a full AI conversation about a topic, then retrieve the transcript after the call ends
  • 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 the account webhook for real-time events; configure per-agent overrides through the API

What your agent can do

Once connected, inspect tool discovery for your server version. The MCP 0.8.0 source exposes 28 tools:

CategoryTools
Accountaccount_overview, get_usage
Phone numberslist_numbers, buy_number
SMSsend_message, get_messages, list_conversations, get_conversation, update_conversation
Voice callslist_calls, get_call, make_call, make_conversation_call
Agentslist_agents, create_agent, update_agent, delete_agent, get_agent, attach_number, detach_number, list_voices
Contactslist_contacts, manage_contact
Webhooksget_webhook, set_webhook, delete_webhook, test_webhook, list_webhook_deliveries

Resources