# Connect Claude to SMS and email with an MCP connector

> 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.

Updated 2026-10-17 · https://agentline.nz/guides/connect-claude-sms-email-mcp

## One-click option

The [install page](https://agentline.nz/install) 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.