Cursor

How to use Twilio with Cursor

You want Twilio inside Cursor so it can monitor inbound customer texts, find unanswered customer conversations, send targeted SMS updates, and follow up on an SMS conversation — without you copy-pasting between tabs. Here is the whole setup, once.

Create your Twilio gateway

The gateway is the thing Cursor connects to, and it is where you decide which Twilio tools an agent may use. You create it once and every client reuses it.

  1. Create an Arcade account

    Sign up and open the dashboard. The free tier is enough to follow this through.

  2. Create an MCP Gateway and select your Twilio tools

    In the dashboard, create a gateway and pick the Twilio tools you want to expose. The gateway is what your client connects to, and it is where tool access is decided.

  3. Copy your gateway URL

    Every client below needs it.

    https://api.arcade.dev/mcp/<YOUR-GATEWAY-SLUG>

  4. Add your Twilio API key

    The gateway can't call Twilio until it has a key. Create one in Twilio, then in the Arcade dashboard open Secrets, click Add Secret and save it under the name the Twilio docs give. Arcade stores it encrypted and the model never sees it.

    Twilio setup in the docs

Connect the gateway to Cursor

Heads up

If the connection drops once the access token expires, set Authorization to “Arcade Headers” on the gateway in the dashboard.

  1. Open MCP settings

    Open Customize in the sidebar, then select MCPs.

  2. Add the gateway

    Select Add New MCP Server, choose HTTP, paste your gateway URL and name the server. Cursor writes the entry to mcp.json:

    {
      "mcpServers": {
        "mcp-arcade": {
          "url": "https://api.arcade.dev/mcp/<YOUR-GATEWAY-SLUG>"
        }
      }
    }

  3. Sign in to Arcade

    Back in MCPs, mcp-arcade shows that it needs a login. Click it and approve the Arcade sign-in that opens in your browser.

  4. Try it out

    Open chat (⌘L / Ctrl+L), switch to Agent mode and ask it to use one of your Twilio tools.

Try these SMS prompts

Cursor can now act on your Twilio account. Copy a prompt and paste it in.

monitor inbound customer texts

Review the newest messages received on each SMS-capable Twilio number. Group them by urgency, summarize anything that needs a response, and return the sender, receiving number, and message for each item.

find unanswered customer conversations

Review my recent SMS conversations and identify contacts whose latest message has not received a reply from us. Return the contact, latest message, conversation date, and a short suggested next step; do not send anything.

send targeted SMS updates

Send this update by SMS from the appropriate Twilio number: [paste the message]. Before sending, show me the destination, sending number, and exact message, then wait for my approval and return the result.

follow up on an SMS conversation

Read the latest messages with [contact or phone number], summarize the context, and draft a concise reply that addresses the open question. Ask for approval before sending it and return the final message and send result.

Use tool permissions to control whether an agent can read messages, list phone numbers, or send SMS. Pair it with Contextual Access policies so it can triage incoming texts without being allowed to send one.

Ready to actually ship your agent?

Free to start. Ready for enterprise when you are.