home / mcp / twilio mcp server

Twilio MCP Server

Reads live Twilio data through MCP with read-only access to answer questions and generate insights.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "cdatasoftware-twilio-mcp-server-by-cdata": {
      "command": "java",
      "args": [
        "-jar",
        "CDataMCP-jar-with-dependencies.jar",
        "/PATH/TO/twilio.prp"
      ]
    }
  }
}

You can run a local, read-only MCP server that exposes live Twilio data through a simple MCP interface. This lets large language models query Twilio data in real time without writing SQL, using natural language questions and built-in MCP tools.

How to use

After you start the MCP server, connect your MCP client to the local stdio server. You will interact with the server using its built-in tools to read data from Twilio. You can ask questions like what is the count of active messages, or retrieve a list of recent calls, and the client will return results by querying Twilio data through the MCP bridge.

How to install

Prerequisites: you need a Java runtime and Maven to build the server. You will also install the CData JDBC Driver for Twilio to enable data access.

# Step 1: Clone the project
git clone https://github.com/cdatasoftware/twilio-mcp-server-by-cdata.git
cd twilio-mcp-server-by-cdata

# Step 2: Build the server
mvn clean install

# This creates the JAR file: CDataMCP-jar-with-dependencies.jar

Step 3: Download and install the CData JDBC Driver for Twilio from the vendor. You will license the driver as part of setup.

Step 4: License the CData JDBC Driver by running the license command from the driver’s installation. Then configure the connection to Twilio using the driver’s connection utility and save the connection string for later use.

Step 5: Create a properties file for the JDBC connection. Use a structure like this to define your MCP server connection details.

Prefix=twilio
ServerName=CDataTwilio
ServerVersion=1.0
DriverPath=PATH\TO\cdata.jdbc.twilio.jar
DriverClass=cdata.jdbc.twilio.TwilioDriver
JdbcUrl=jdbc:twilio:InitiateOAuth=GETANDREFRESH;
Tables=

Additional configuration and running details

To run the MCP server on your machine, use the final start command that includes the generated JAR and your prp file. The server runs via stdio, so it is intended to be used with a local client on the same machine.

java -jar /PATH/TO/CDataMCP-jar-with-dependencies.jar /PATH/TO/twilio.prp

Notes on usage with Claude Desktop or other MCP clients

Configure your MCP client to load the local MCP server by specifying the java command and the path to the MCP JAR with your prp file. You will typically place this in your client’s MCP server configuration and restart the client to discover the new server.

Available tools

twilio_get_tables

Retrieves a list of available tables from the Twilio data source. The output is in CSV where the first line contains column headers.

twilio_get_columns

Retrieves a list of columns for a specified table. The output is CSV with column headers on the first line.

twilio_run_query

Executes a SQL SELECT query against the Twilio data source and returns the result set.