Menu
How it worksPricingFor agentsInstallDocsGuidesSign inStart free

Connect Claude to SMS and email with an MCP connector

Updated · Markdown

Short answer

In Claude, open Customize → Connectors, add a custom connector with the URL https://agentline.nz/mcp, click Connect and sign in to Agentline. Claude then has tools to send and read SMS from its own NZ 028 number, send and read email from an @agentline.nz inbox, and wait for one-time codes. In Claude Code, run claude mcp add --transport http agentline https://agentline.nz/mcp.

One-click option

The install page has an Add to Claude button that opens the custom connector dialog with the name and URL filled in.

Permissions

Agentline asks for two scopes: messages:read (always) and messages:send (optional). Without the send scope, Claude can read messages and codes but can't text or email anyone. Every tool is labelled read-only or not, so Claude asks before anything that sends.

Claude Code

claude mcp add --transport http agentline https://agentline.nz/mcp

Then type /mcp, pick agentline and choose Authenticate. To use an API key instead, add --header "Authorization: Bearer al_live_…".

What Claude can do

  • Text a NZ mobile and read the reply (send_sms, list_messages).
  • Send and read email from its own address (send_email, list_emails, read_email), up to 5 recipients per message.
  • Finish a sign-up by waiting for the code (wait_for_code). It waits up to 55 seconds, and each code is handed out once, so a retry never reuses a stale one.
  • On Pro, see calls and voicemail transcripts (list_calls).

Things to try first

  • "What's my Agentline number and email address?"
  • "Sign up for the newsletter at example.co.nz with my Agentline email and confirm it."
  • "Text 021 123 4567 to say I'm running ten minutes late." (On Free and trial accounts this works only for your own verified mobile.)

Safe defaults

New accounts can message only the owner's verified email and mobile until they're on a paid plan. SMS content is checked before sending: marketing, link shorteners, phishing patterns and impersonation are refused, and anyone who replies STOP is opted out at once.

Steps

  1. Open connectors. In claude.ai or Claude Desktop, go to Customize → Connectors and choose Add custom connector. On Team and Enterprise plans an Owner adds it under Organisation settings first.
  2. Enter the URL. Name it Agentline and use https://agentline.nz/mcp. Leave the advanced OAuth fields empty.
  3. Connect and approve. Click Connect, sign in to Agentline and approve access. Allow sending if you want Claude to text and email.
  4. Enable it in a chat. Turn the connector on from the tools menu in a conversation and ask Claude for your Agentline number.

Common questions

Does Claude ask before sending a text?
Yes. Agentline marks its sending tools as write actions, so Claude asks you to approve them. You can also connect without the messages:send scope, so Claude can read messages and codes but can't send, call or change settings.
Can I use Agentline in Claude Code without OAuth?
Yes. Create an API key in the Agentline dashboard and add it with --header "Authorization: Bearer al_live_…" when you run claude mcp add.
Can Claude read one-time codes?
Yes. In Claude, wait_for_code returns the code from an SMS or email so Claude can finish a sign-up. Each code is returned once.

Give your agent a number

Inbox live from day one; NZ 028 number set up within a few days of signup.

Get started

Related guides