Twilio Flex MCP server

Connect Twilio Flex to Claude, ChatGPT, Cursor, Claude Code, Codex, Gemini, GitHub Copilot and any other MCP client, for your whole team. Metorial adds security, governance, and tracing, and gives everyone one Magic MCP URL to connect.

What you can do with the Twilio Flex MCP server

Ask your agent in plain language. Each of these maps to a real tool on the server.

  • Use the manage interaction participants tool in Twilio Flex
  • Use the manage task queues tool in Twilio Flex
  • Use the create interaction tool in Twilio Flex
  • Use the manage interaction channel tool in Twilio Flex
  • Use the manage workflows tool in Twilio Flex
  • Use the manage flex flows tool in Twilio Flex

Supported Tools

manage_interaction_participants

Manage Interaction Participants

Add, remove, or list participants in a Flex interaction channel. Add requires the native Type and MediaProperties payload, with optional RoutingProperties. Closing a participant changes its task/reservation state and retains history; it does not delete the interaction.

manage_task_queues

Manage Task Queues

Create, read, update, delete, or list task queues in a TaskRouter workspace. Task queues hold tasks waiting to be assigned to workers. Each queue has a target worker expression that determines which workers are eligible to receive tasks from it.

create_interaction

Create Interaction

Create a new customer interaction in Twilio Flex. Use this to initiate inbound or outbound conversations across supported messaging channels. Specify the channel type, routing configuration, and participant details.

manage_interaction_channel

Manage Interaction Channel

Get details or update the status of a channel within a Flex interaction. Use this to close a channel, fetch channel status, or list all channels for an interaction.

manage_workflows

Manage Workflows

Create, read, update, delete, or list workflows in a TaskRouter workspace. Workflows define the routing rules that determine how tasks are assigned to workers based on task attributes and queue configurations.

manage_flex_flows

Manage Flex Flows

Legacy Programmable Chat in Flex reached end of life on June 1, 2026 and may stop working. Migrate to Flex Conversations and Interactions. This tool preserves documented legacy CRUD. Create, read, update, delete, or list Flex Flows. A Flex Flow defines how incoming messages on a given channel (SMS, WhatsApp, web chat, etc.) are routed into the Flex contact center. It links a messaging channel to Flex and specifies the integration type (Studio flow, external webhook, or direct task creation).

manage_workers

Manage Workers

Create, read, update, delete, or list workers (agents) in a TaskRouter workspace. Workers represent the agents who handle tasks in your Flex contact center. You can update their attributes and current activity. Activity availability determines whether they can accept tasks.

manage_tasks

Manage Tasks

Create, read, update, cancel, or list tasks in a TaskRouter workspace. Tasks represent units of work that need to be routed to workers. You can create new tasks, update their attributes or priority, complete or cancel them, and filter the task list by status or assignment.

manage_conversations

Manage Conversations

Create, read, update, delete, or list Twilio Conversations. Conversations are the container for multi-party messaging across channels. Use this to set up new conversation threads, update their state, or retrieve conversation details.

manage_conversation_participants

Manage Conversation Participants

Add, remove, update, or list participants in a Twilio Conversation. Participants can be chat-based (identity) or SMS/WhatsApp-based (phone number). Use this to manage who is part of a conversation.

manage_studio_flows

Manage Studio Flows

List, get, or trigger Studio Flow executions. Studio Flows are visual communication workflows for IVR, chatbot logic, and routing. Use this to view available flows, trigger outbound flow executions, or check execution history.

manage_activities

Manage Activities

Create, read, update, delete, or list activities in a TaskRouter workspace. Activities describe what workers are doing (e.g., "Available", "Break", "Offline") and whether they are eligible to receive new task assignments.

get_workspace_statistics

Get Workspace Statistics

Retrieve real-time and cumulative statistics for a TaskRouter workspace. Returns metrics like total tasks, tasks by status, average wait time, available workers, and activity-level breakdowns. Optionally fetch per-queue or per-worker statistics.

send_conversation_message

Send Conversation Message

Send a message in a Twilio Conversation. Supports text messages and can optionally specify the author identity. Use this to programmatically send messages within an active conversation thread.

list_conversation_messages

List Conversation Messages

List messages in a Twilio Conversation. Returns the message history for a given conversation, including author, body, and timestamps. Use order parameter to sort ascending or descending.

get_flex_configuration

Get Flex Configuration

Retrieve the current Flex instance configuration. Returns UI settings, enabled channels, account SID, runtime domain, and other configuration properties that control the appearance and behavior of your Flex instance.

list_workspaces

List Workspaces

Discover authorized TaskRouter workspaces and their native SIDs before managing workers, queues, tasks, workflows or statistics.

get_interaction

Get Interaction

Read one exact Flex interaction and its native channel/routing details after asynchronous acceptance. Use manage_interaction_channel to inspect setup or failure status; acceptance alone does not establish successful delivery or routing.

Connect Twilio Flex to your AI client

Every client uses the same Magic MCP URL, and so does any other MCP client. Add it once and sign in with SSO.

  1. Enable Twilio Flex in Metorial. In your Metorial portal, enable the Twilio Flex MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
  2. Add a custom connector. Open Customize, then Connectors. Select Add, then Custom, then Web.
  3. Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>) and continue.
  4. Sign in. Select Add and sign in to load Twilio Flex tools.

Run Twilio Flex through the Metorial gateway

One governed layer for every app your agents reach, not a separate connector per tool.

  • Give Twilio Flex and every other app to your whole team through one MCP gateway, behind your SSO.
  • Scope which teams and agents can use Twilio Flex tools with role-based access control, and trace every call.
  • Prefer to run it yourself? Metorial is open source and self-hostable.

More integrations teams use with Twilio Flex

Notion

Create, read, update, and archive pages and databases in a Notion workspace. Manage blocks (paragraphs, lists, headings, embeds, etc.) within pages. Query databases with filters and sorts across rich property types including text, numbers, dates, selects, relations, and formulas. Search across pages and databases by title. Add and read comments on pages and blocks. Upload files to pages. Manage workspace users and retrieve user profiles.

GitHub

Manage repositories, issues, and pull requests. Create and configure branches, star repositories, review code, and merge changes. Automate CI/CD workflows with GitHub Actions, manage workflow runs, secrets, and artifacts. Track issues with labels, milestones, and assignees. Search across code, repositories, issues, and users. Manage organizations, teams, and memberships. Create and manage projects, gists, packages, deployments, and environments. Access security alerts including code scanning, secret scanning, and Dependabot alerts. Read and write file contents in repositories. Manage webhooks, notifications, and codespaces.

Slack

Slack: connect with bot OAuth or user OAuth to work with messages, conversations, search, files, Canvases, Lists, profiles, reactions, reminders, and workspace productivity settings.

Salesforce

Manage CRM data including Accounts, Contacts, Leads, Opportunities, Cases, and custom objects. Create, read, update, and delete records. Query data using SOQL and search across objects using SOSL. Perform bulk data operations for large-scale imports, exports, and migrations. Execute composite requests to batch multiple operations in a single API call. Access analytics, reports, and dashboards. Manage files and attachments associated with records. Interact with Chatter feeds, posts, and groups for social collaboration. Manage org metadata including custom objects, fields, layouts, and workflows. Query data using GraphQL for precise data retrieval across related objects.

Apolloio

Search and prospect B2B contacts and companies from a database of over 275 million people and 70 million organizations. Enrich people and company data with emails, phone numbers, and firmographic details. Create and manage contacts, accounts, deals, and tasks. Add contacts to email sequences and manage sequence statuses. Log and search call records. Perform bulk operations for contact creation, account creation, task creation, and data enrichment.

Sharepoint

Manage SharePoint sites, document libraries, lists, and files. Create, read, update, and delete lists and list items with custom columns. Resolve site users to numeric Person/Group LookupId values. Upload, download, move, copy, and version files in document libraries. Search across sites, files, folders, lists, and list items using Microsoft Search. Manage permissions at site, list, and item levels with granular access control. Define and manage content types and site columns. Retrieve site properties and search for sites across Microsoft 365.

Technical notes for Twilio Flex

Discover TaskRouter workspaces, inspect Flex configuration, manage controlled workers, tasks, queues, workflows and activities, and read contact-center statistics. Create asynchronous Flex messaging interactions, inspect channel status, and manage Conversations, participants and messages. Read Studio flows/executions or explicitly start an execution. Documented legacy Flex Flow CRUD remains available with a Programmable Chat end-of-life warning.

Frequently asked questions

Common questions about connecting Twilio Flex to AI agents with Metorial.

  1. How many tools does the Twilio Flex MCP server have?
    The Twilio Flex MCP server exposes 18 tools, including Manage Interaction Participants, Manage Task Queues, Create Interaction. Each one is governed and traced through Metorial.
  2. Twilio Flex exposes tools your agents call on demand; it does not publish event triggers yet. Everything still runs through one governed MCP URL.
  3. Any MCP client, including VS Code, Windsurf, Zed, OpenCode and Grok. Each one reaches the Twilio Flex MCP server through the same Metorial URL.
  4. Use role-based access control to decide which teams, users, and agents can use Twilio Flex and which of its tools they can call.
  5. Yes. Metorial is open source, so you can run the Twilio Flex MCP server yourself or use the hosted gateway.

Connect Twilio Flex to production AI agents

See how Metorial gives your team governed access to Twilio Flex, with tracing and security controls built in.