Twilio

The Twilio agent connector is a Python package that equips AI agents to interact with Twilio through strongly typed, well-documented tools. It's ready to use directly in your Python app, in an agent framework, or exposed through an MCP.

Connector for the Twilio REST API. Provides read access to core Twilio resources including accounts, calls, messages, recordings, conferences, incoming phone numbers, usage records, addresses, queues, transcriptions, and outgoing caller IDs. Uses HTTP Basic authentication with Account SID and Auth Token.

Example questions

The Twilio connector is optimized to handle prompts like these.

• List all calls from the last 7 days
• Show me recent inbound SMS messages
• List all active phone numbers on my account
• Show me details for a specific call
• List all recordings
• Show me conference calls
• List usage records for my account
• Show me all queues
• List outgoing caller IDs
• Show me addresses on my account
• List transcriptions
• What are my top 10 most expensive calls this month?
• How many SMS messages did I send vs receive in the last 30 days?
• Summarize my usage costs by category
• Which phone numbers have the most incoming calls?
• Show me all failed messages and their error codes
• What is the average call duration for outbound calls?

Unsupported questions

The Twilio connector isn't currently able to handle prompts like these.

• Send a new SMS message
• Make a phone call
• Purchase a new phone number
• Delete a recording
• Create a new queue

Installation

uv pip install airbyte-agent-twilio

Usage

Connectors can run in open source or hosted mode.

Open source

In open source mode, you provide API credentials directly to the connector.

from airbyte_agent_twilio import TwilioConnector
from airbyte_agent_twilio.models import TwilioAuthConfig

connector = TwilioConnector(
    auth_config=TwilioAuthConfig(
        account_sid="<Your Twilio Account SID (starts with AC)>",
        auth_token="<Your Twilio Auth Token>"
    )
)

@agent.tool_plain # assumes you're using Pydantic AI
@TwilioConnector.tool_utils
async def twilio_execute(entity: str, action: str, params: dict | None = None):
    return await connector.execute(entity, action, params or {})

Hosted

In hosted mode, API credentials are stored securely in Airbyte Cloud. You provide your Airbyte credentials instead. If your Airbyte client can access multiple organizations, also set organization_id.

This example assumes you've already authenticated your connector with Airbyte. See Authentication to learn more about authenticating. If you need a step-by-step guide, see the hosted execution tutorial.

from airbyte_agent_twilio import TwilioConnector, AirbyteAuthConfig

connector = TwilioConnector(
    auth_config=AirbyteAuthConfig(
        customer_name="<your_customer_name>",
        organization_id="<your_organization_id>",  # Optional for multi-org clients
        airbyte_client_id="<your-client-id>",
        airbyte_client_secret="<your-client-secret>"
    )
)

@agent.tool_plain # assumes you're using Pydantic AI
@TwilioConnector.tool_utils
async def twilio_execute(entity: str, action: str, params: dict | None = None):
    return await connector.execute(entity, action, params or {})

Full documentation

Entities and actions

This connector supports the following entities and actions. For more details, see this connector's full reference documentation.

Entity	Actions
Accounts	List, Get, Search
Calls	List, Get, Search
Messages	List, Get, Search
Incoming Phone Numbers	List, Get, Search
Recordings	List, Get, Search
Conferences	List, Get, Search
Usage Records	List, Search
Addresses	List, Get, Search
Queues	List, Get, Search
Transcriptions	List, Get, Search
Outgoing Caller Ids	List, Get, Search

Authentication

For all authentication options, see the connector's authentication documentation.

Twilio API docs

See the official Twilio API reference.

Version information

• Package version: 0.1.1
• Connector version: 1.0.1
• Generated with Connector SDK commit SHA: e50d6dd2afcab025208f4c255431a51c213a1c5c
• Changelog: View changelog