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.
-
Create an Arcade account
Sign up and open the dashboard. The free tier is enough to follow this through.
-
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.
-
Copy your gateway URL
Every client below needs it.
-
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.
-
Open MCP settings
Open Customize in the sidebar, then select MCPs.
-
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:
-
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.
-
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.