Twilio Manager

by errajibadr

1 stars
267 downloads
Not rated
GitHub

About

Manages Twilio resources through asynchronous API interactions, enabling efficient concurrent operations for subaccounts, phone numbers, addresses, and regulatory bundles with features like resource transfers and duplication.

Details

Author
errajibadr
Repository
errajibadr/twilio_manager_mcp
GitHub stars
1
Downloads
267
Categories
Design, Developer Tools, AI, Frontend, API, Infrastructure, Security, Communication

- List Twilio subaccounts
- Get phone numbers associated with subaccounts
- Transfer phone numbers between subaccounts
- Get regulatory bundle SIDs
- Support for both direct and Server-Sent Events (SSE) communication
- Integration with Claude Desktop, Cursor, and other MCP-compatible tools

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Twilio Manager
    Command (node, npx, python, etc.) uv
    Arguments
    • Argument 1 --directory
    • Argument 2 /path/to/twilio_manager_mcp
    • Argument 3 run
    • Argument 4 mcp
    • Argument 5 run
    • Argument 6 ./twilio_manager_mcp.py
    Environment
    • TWILIO_AUTH_TOKEN your_auth_token
    • TWILIO_ACCOUNT_SID your_account_sid

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

On macOS:

brew install uv

On Windows:

powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

On Linux:

curl -LsSf https://astral.sh/uv/install.sh | sh

1. Clone the repository:

git clone https://github.com/yourusername/twilio_manager_mcp.git
cd twilio_manager_mcp

2. Install dependencies using uv:

uv sync

DOMAIN_NAME=yourdomain.com
ACME_EMAIL=user@yourdomain.com

Once configured, you can use the tools directly in your AI assistant conversations:

1. List all subaccounts:


For direct programmatic usage:

python
from mcp import ClientSession
from clients.client import MCPClient

async with MCPClient("uvx", ["twilio-manager-mcp"], env={}) as session:

uv venv

source .venv/bin/activate # On Unix
.venv\Scripts\activate # On Windows

uv pip install -e .
```

list_twilio_subaccounts

List all Twilio subaccounts.

get_account_phone_numbers

Get phone numbers for a specific subaccount.

get_all_phone_numbers

Transfer phone numbers between subaccounts.

get_regulatory_bundle_sid

Get regulatory bundle SID for a subaccount.

| Tool Name | Description |
|-----------|-------------|
| list_twilio_subaccounts | List all Twilio subaccounts |
| get_account_phone_numbers | Get phone numbers for a specific subaccount |
| get_all_phone_numbers | Transfer phone numbers between subaccounts |
| get_regulatory_bundle_sid | Get regulatory bundle SID for a subaccount |

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "twilio manager": {
            "env": {
                "TWILIO_AUTH_TOKEN": "your_auth_token",
                "TWILIO_ACCOUNT_SID": "your_account_sid"
            },
            "args": [
                "--directory",
                "/path/to/twilio_manager_mcp",
                "run",
                "mcp",
                "run",
                "./twilio_manager_mcp.py"
            ],
            "command": "uv"
        }
    }
}

Linux

{
    "env": {
        "TWILIO_AUTH_TOKEN": "your_auth_token",
        "TWILIO_ACCOUNT_SID": "your_account_sid"
    },
    "args": [
        "--directory",
        "/path/to/twilio_manager_mcp",
        "run",
        "mcp",
        "run",
        "./twilio_manager_mcp.py"
    ],
    "command": "uv"
}

Macos

{
    "env": {
        "TWILIO_AUTH_TOKEN": "your_auth_token",
        "TWILIO_ACCOUNT_SID": "your_account_sid"
    },
    "args": [
        "--directory",
        "/path/to/twilio_manager_mcp",
        "run",
        "mcp",
        "run",
        "./twilio_manager_mcp.py"
    ],
    "command": "uv"
}

Windows

{
    "env": {
        "TWILIO_AUTH_TOKEN": "your_auth_token",
        "TWILIO_ACCOUNT_SID": "your_account_sid"
    },
    "args": [
        "twilio-manager-mcp"
    ],
    "command": "uvx"
}

Twilio Manager MCP

A Model Context Protocol (MCP) implementation for managing Twilio resources. This package provides tools for managing Twilio subaccounts, phone numbers, and regulatory bundles through a standardized MCP interface.

<a href="https://glama.ai/mcp/servers/@errajibadr/twilio_manager_mcp">
TwilioManager MCP server
</a>

Features

- List Twilio subaccounts
- Get phone numbers associated with subaccounts
- Transfer phone numbers between subaccounts
- Get regulatory bundle SIDs
- Support for both direct and Server-Sent Events (SSE) communication
- Integration with Claude Desktop, Cursor, and other MCP-compatible tools

Installation

Prerequisites

Install uv

On macOS:

brew install uv

On Windows:

powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

On Linux:

curl -LsSf https://astral.sh/uv/install.sh | sh

Project Setup

1. Clone the repository:

git clone https://github.com/yourusername/twilio_manager_mcp.git
cd twilio_manager_mcp

2. Install dependencies using uv:

uv sync

Configuration

1. Create a .env file in the root directory with your Twilio credentials:

TWILIO_ACCOUNT_SID=your_account_sid
TWILIO_AUTH_TOKEN=your_auth_token

2. Configure MCP for your tool (Cursor, Claude Desktop, etc.) by creating a .cursor/mcp.json file:

{
  "mcpServers": { 
    "twilio_manager_mcp_abs": {
      "command": "uv",
      "args": ["--directory", "/path/to/twilio_manager_mcp", "run", "mcp", "run", "./twilio_manager_mcp.py"],
      "env": {
        "TWILIO_ACCOUNT_SID": "your_account_sid",
        "TWILIO_AUTH_TOKEN": "your_auth_token"
      }
    },
    "twilio_manager_mcp_uvx": {
      "command": "uvx",
      "args": [ "twilio-manager-mcp" ],
      "env": {
        "TWILIO_ACCOUNT_SID": "your_account_sid",
        "TWILIO_AUTH_TOKEN": "your_auth_token"
      }
    },
    "twilio_manager_mcp_sse": {
      "url": "http://localhost:8000/sse"
    }
  }
}

Docker

You can run Twilio Manager MCP using Docker for easier deployment and management.

Using Docker Compose

The project includes a Docker Compose configuration that sets up:
- The Twilio Manager MCP service
- A Traefik reverse proxy with automatic HTTPS

1. Configure environment variables in your .env file:

```env

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.