Claude Connector

Remote MCP connector for AI agents

The Mailpipe connector is a remote Model Context Protocol (MCP) server that lets AI clients like Claude read, organize, and send email on your behalf. Add it once with the connector URL, authorize with OAuth, and your assistant can work your inbox directly in chat.

What it is

The Mailpipe connector is a hosted, remote MCP server. Unlike a local MCP server that you install and run yourself, the connector lives at a public URL and authenticates with OAuth — there is nothing to install and no API key to paste. You add the URL in your AI client, approve the permissions on a Mailpipe consent screen, and the client can then use Mailpipe's email tools on your behalf within the scopes you granted.

Connector URL

Add this URL in Claude
https://www.mailpipe.dev/api/mcp

This URL works today with no DNS changes. A branded mcp.mailpipe.dev alias may be offered in the future, but https://www.mailpipe.dev/api/mcp is the canonical address.

Add it in Claude

1

Open connector settings

In Claude, go to Settings → Connectors and choose Add custom connector.

2

Paste the connector URL

Enter the Mailpipe connector URL and continue:

Connector URL
https://www.mailpipe.dev/api/mcp
3

Authorize with OAuth

Claude redirects you to Mailpipe to sign in. Review the permissions (scopes) the connector is requesting on the consent screen, then approve. You will be returned to Claude with the connector ready to use.

4

Start using it

The Mailpipe tools are now available in your conversations. Try one of the sample prompts below.

Revoking access

You can disconnect the connector at any time from Claude's connector settings, or revoke the underlying OAuth token from your Mailpipe dashboard. Either action immediately invalidates the connector's access. See the Privacy Policy for details.

OAuth scopes

During authorization you approve a set of scopes that define exactly what the connector may do on your behalf. Grant only the scopes you need — for a read-only assistant, mail:read alone is enough.

ScopeWhat it allows
mail:readRead your emails, threads, and attachments, and search your inbox.
mail:sendSend new emails, replies, and forwards from your connected addresses.
mail:writeModify messages — archive, delete, mark read/unread, star, and label.
mail:draftsCreate and manage drafts before they are sent.
mailbox:readList the mailboxes connected to your organization.
mailbox:writeManage mailboxes.
labels:readList your email labels.
labels:writeCreate and modify labels.

What the assistant can do

Once connected, your assistant can call Mailpipe's email tools. A representative selection is below — see the MCP Server reference for the full tool and resource catalog.

summarize_inbox

Inbox summary with unread count and recent messages

mail:read
list_messages

List messages with filters for mailbox, read/starred status, and labels

mail:read
search_messages

Full-text search across all messages

mail:read
get_message

Get a single message including full content and attachments

mail:read
get_thread

Get a thread with all of its messages

mail:read
send_message

Send a new email

mail:send
reply_to_message

Reply to an existing message

mail:send
forward_message

Forward a message to new recipients

mail:send
create_draft

Create a draft to review before sending

mail:drafts
archive_message

Archive a message (removed from inbox, not deleted)

mail:write
apply_label

Apply a label to a message

mail:write
list_mailboxes

List connected mailboxes

mailbox:read

Sample prompts

Once the connector is authorized, try asking Claude things like:

Summarize my unread emails from today and tell me which ones need a reply.

Draft a reply to the latest message from Arpan letting them know I will review the proposal by Friday.

Send an email to investors@example.com with the subject "Q3 update" saying the metrics deck is attached and I will follow up next week.

Search my inbox for anything about the Vercel invoice and tell me the amount due.

Archive every newsletter in my inbox and label the rest "to-review".

Support

support@mailpipe.dev

Questions about the connector, scopes, or authorization? Reach out and we'll help.

Still have questions?

Our team is here to help with anything from setup to scaling.

Contact support