@kody/twilio
Look up Twilio accounts, incoming numbers, and SMS logs, and send messages as a dry-run by default.
OtherTopics: twilio, sms, messaging, phone, account-sid, auth-token, dry-run
- Version
- 1.0.0
- License
- MIT
- Published
- September 10, 2026
- Pinned commit
156b13b- Rating
- No ratings yet
- Forks
- 0
- Adaptation effort
- —
README
Agent docs@kody/twilio
Official Twilio four-dot mark (Simple Icons path of Twilio's logo) in Signal Red #F22F46. Twilio® is a trademark of Twilio Inc. This package is not affiliated with or endorsed by Twilio.
Share this package as https://kody.codes/@kody/twilio
(never a /community/{listing_id} URL).
Intent
Provide reusable, account-agnostic Twilio helpers so Kody can look up the
caller's account, list incoming numbers, read message logs, and send SMS.
Auth is a saved Account SID plus Auth Token. Sends default to dry-run and
need confirm: true for a live message. No personal phone numbers belong in
this package — pass from/to or a Messaging Service SID at call time.
This listing is meant to be forked. The live @kody/twilio package does not
talk to a shared Twilio account.
What it does
- Look up the caller's Twilio account profile (never returns
auth_token) - List incoming phone numbers and recent SMS/MMS logs
- Preview or send SMS (
send-messagedefaults to dry-run) - Optionally store a Messaging Service SID in forked
packageStorage() - Call uncommon 2010-04-01 Account paths through
./request
Prerequisites / setup
Account SID + Auth Token (secret-backed HTTP Basic). There is no Twilio
OAuth integration and no baked-in sender. Do not open /connect/oauth for
Twilio.
| Secret | Purpose |
|---|---|
twilioAccountSid | Account SID (AC…) used as the Basic username and in the REST path |
twilioAuthToken | Auth Token used as the Basic password |
Optional readable default (not a secret): store a Messaging Service SID (MG…)
in this package's packageStorage() after you fork. Live @kody/twilio
storage is the platform bucket — fork first.
- Copy the Account SID and Auth Token from the Twilio Console. Never paste them into chat.
- Save the Account SID:
https://kody.codes/account/secrets/new?name=twilioAccountSid&description=Twilio%20Account%20SID%20(AC...)&allowedHosts=api.twilio.com&scope=user
- Save the Auth Token:
https://kody.codes/account/secrets/new?name=twilioAuthToken&description=Twilio%20Auth%20Token&allowedHosts=api.twilio.com&scope=user
- Approve host
api.twilio.comfor both secrets.
Additional accounts
Pass account: "work" to use twilioAccountSid-work / twilioAuthToken-work,
or pass accountSidSecret / authTokenSecret explicitly.
https://kody.codes/account/secrets/new?name=twilioAccountSid-work&description=Twilio%20Account%20SID%20(AC...)&allowedHosts=api.twilio.com&scope=user
https://kody.codes/account/secrets/new?name=twilioAuthToken-work&description=Twilio%20Auth%20Token&allowedHosts=api.twilio.com&scope=user
Agents: see AGENTS.md for import paths, smoke checks, and
mutation guards.
Done when
twilioAccountSidandtwilioAuthTokenare saved; hostapi.twilio.comis approved- Smoke test returns
ok: true(live account + numbers/logs sample when secrets exist; never sends SMS) send-messagepreviews by default; live sends needconfirm: trueplusfromor a Messaging Service SID- No personal phone numbers are baked into the package
Branding
Keep LICENSE (MIT), ## Intent, and community-icon.svg intact for community listing.
Docs
Report this listing
Log in to report this listing.