openai-agents-agentphone

AgentPhone tools for the OpenAI Agents SDK — let your AI agents send SMS messages, make phone calls, and manage phone numbers.

Installation

pip install openai-agents-agentphone

Setup

Get your API key from agentphone.to and set it as an environment variable:

export AGENTPHONE_API_KEY="your-api-key"

Quick Start

Use all tools

from agents import Agent
from openai_agents_agentphone import get_tools

agent = Agent(
    name="Phone Assistant",
    instructions="You help users manage phone numbers, send messages, and make calls.",
    tools=get_tools(),
)

Use specific tools

from openai_agents_agentphone import get_tools

tools = get_tools(selected=["send_sms", "list_numbers", "make_call"])

Use individual tools

from agents import Agent
from openai_agents_agentphone import agentphone_send_sms, agentphone_make_call

agent = Agent(
    name="Outbound Agent",
    instructions="You make calls and send messages on behalf of the user.",
    tools=[agentphone_send_sms, agentphone_make_call],
)

Configure API key in code

from openai_agents_agentphone import configure

configure(api_key="your-api-key")

Full example with Runner

import asyncio
from agents import Agent, Runner
from openai_agents_agentphone import configure, get_tools

configure(api_key="your-api-key")

agent = Agent(
    name="Phone Assistant",
    instructions="You help users with phone calls and messages via AgentPhone.",
    tools=get_tools(),
)

async def main():
    result = await Runner.run(agent, "List my phone numbers")
    print(result.final_output)

asyncio.run(main())

Available Tools

API Reference

See the AgentPhone documentation for full API details.