Mailtea

Mailtea Agent Plugin

Send email and newsletters. Just ask.

Mailtea lets your AI assistant send and schedule email, check delivery, write and design newsletters, manage contacts, and build your publication's website, all from a conversation. It is for newsletter writers, creators and teams who send with Mailtea, and for developers who want an agent to handle email without writing integration code.

What you get

167 tools, grouped by what they work on:

Three skills, ready when you need them

Your assistant picks the relevant skill from your request. You can also name a skill if you want to be explicit.

The plugin does not replace Mailtea Studio, or the SDKs and CLI for application code. Use it when an AI assistant should do the work for you.

Connect

More clients, and a one-line install for each, are under Get started.

The first time you connect, you sign in to Mailtea in your browser, pick one publication, and choose an access level from read only to full access. Your assistant can act only inside that publication at that level, and you can revoke the connection in Mailtea at any time.

Docs · Support · Privacy policy · Terms of service

Get started

You need a Mailtea account. Sending also needs a verified sending domain. The hosted connection needs no API key, no Node.js install, and no code. You sign in through your browser.

npx plugins add is the universal path. The plugins CLI reads this package's plugin.json and installs it into whichever agent tools it detects: Claude Code, Cursor, Codex, Grok Build, Kimi Code, GitHub Copilot CLI, and VS Code. Use -t to pick one, and npx plugins targets to see what it found.

Then open a new session, connect Mailtea through the browser sign-in prompt, choose your publication and the access you want to grant, and paste:

Help me send my first email with Mailtea. Check my setup and guide me through anything missing.

Your agent checks the publications, senders, and domain verification available to your account, and explains the next step for anything missing. You do not need to know tool names or pick a skill.

Need an account? Start with Mailtea. Need a sending domain? Domain setup.

Manual configuration

Every entry points at the same hosted server, https://api.mailtea.app/mcp. Unless a row above says otherwise, you sign in through your browser the first time the client connects, and there is no key to paste.

Cline (cline_mcp_settings.json):

{"mcpServers": {"mailtea": {"type": "streamableHttp", "url": "https://api.mailtea.app/mcp"}}}

Zed (settings.json):

{"context_servers": {"mailtea": {"url": "https://api.mailtea.app/mcp"}}}

Warp (Settings, then Agents, then MCP servers):

{"mailtea": {"url": "https://api.mailtea.app/mcp"}}

JetBrains AI Assistant: it cannot sign in through the browser yet, so send a Mailtea personal access token (create one in Settings → API keys) as the Authorization header. Junie signs in through the browser and needs no header.

{"mcpServers": {"mailtea": {"url": "https://api.mailtea.app/mcp", "headers": {"Authorization": "Bearer mt_pat_xxx"}}}}

Amazon Q Developer CLI (agent configuration file), then run /mcp in a session and open the sign-in link it prints:

{"mcpServers": {"mailtea": {"type": "http", "url": "https://api.mailtea.app/mcp"}}}

Copy a prompt

Send one email. Replace the bracketed details with your own:

Send an email from [my verified sender] to [recipient]. Subject: [subject]. Message: [body].

Schedule a send:

Schedule this email for [date and time, including time zone]. Use [verified sender] and send only to [recipient].

Check delivery:

Check my recent Mailtea emails and explain any failed deliveries.

Create a newsletter draft:

Draft a newsletter for [publication] about [topic]. Give it a clear subject and one call to action. Do not send it yet.

Design your website:

Draft a home page for [publication] using its brand and existing content. Do not publish it yet.

What happens when you ask

• Draft means draft. Draft requests do not send email or publish a website.
• You choose who receives an email. Your agent asks for missing details and uses the sender, recipients, and content you supply or approve.
• An email ID means accepted, not delivered. Ask for delivery status to check the result. Do not repeat a send after a timeout until its status is known.
• Your permissions apply. The connection only reaches what your Mailtea account and the access you grant allow.

If you get stuck

Reconnecting per client

Package layout

**The r