Business email on your own domain: mailboxes, send and read mail, aliases, DNS setup, and campaigns.
com.faivelo/mail Model Context Protocol (MCP) Server
The com.faivelo/mail MCP server provides business email functionality on your own domain. It covers creating and managing mailboxes, sending and reading mail, configuring aliases, handling DNS setup, and running campaigns. The server is associated with the slug com-faivelo-mail.
🛠️ Key Features
Mailboxes
Send and read mail
Aliases
DNS setup
Campaigns
🚀 Use Cases
Set up and manage email on a custom domain
Handle outbound and inbound email workflows
Create and maintain aliases
Configure DNS for email delivery
Manage email campaigns
⚡ Developer Benefits
Server-scoped access to domain email operations described as mailboxes, mail send/read, aliases, DNS setup, and campaigns
⚠️ Limitations
Available details only cover the listed email/DNS/campaign capabilities; no additional tools or technical constraints are provided
Give Claude, ChatGPT, Cursor, Codex or any AI agent a real email inbox on
your own domain. Your assistant can read and search your mail, draft and
send replies, schedule sends, file messages away, create new addresses for
itself, and fix your domain's DNS. You choose exactly which mailboxes it can
see.
Useful when you want to:
let your coding agent set up hello@yourcompany.com for the site it just built
give an AI agent its own address to sign up for services and receive verification codes
triage, summarise and answer a support inbox from Claude
send a reply from your real address without opening a mail app
Server URL:https://faivelo.com/api/mcp (streamable HTTP, OAuth 2.1, no API key to paste)
Registry name:com.faivelo/mailAccess: a Faivelo account. MCP is included on Growth and up, and in the
free trial (no card). Plans
Install
Client
One command
Claude Code (plugin: MCP + skill)
/plugin marketplace add ethannschwartz/faivelo-mcp then /plugin install faivelo@faivelo
Claude Code (MCP only)
claude mcp add --transport http faivelo https://faivelo.com/api/mcp
The first call opens a browser sign-in, where you choose exactly which
mailboxes the assistant can reach.
Headless agents (no browser): send an API key instead,
Authorization: Bearer fvl_live_.... Create an agent key at
Settings → Developers; it
only reaches the mailboxes it creates or is granted.
Cursor
Two ways in. Both sign you in through the browser on the first call; there
is no key to paste.
Plugin (once it is listed on the Cursor Marketplace): type
/add-plugin faivelo in the agent chat, or find Faivelo under
Settings → Plugins. The plugin installs the MCP server, the
faivelo-email skill and a rule that teaches the agent to set up email on
a domain, send from an app and verify webhooks.
Server only: Add to Cursor,
or put { "mcpServers": { "faivelo": { "url": "https://faivelo.com/api/mcp" } } }
in .cursor/mcp.json (this project) or ~/.cursor/mcp.json (every project).
Add "headers": { "Authorization": "Bearer fvl_live_..." } for a headless setup.
Cursor sends at most about 40 tools to the model across every MCP server
you have enabled. Faivelo exposes 30 to 33 tools on an OAuth connection
(37 with an API key), so if you run other servers alongside it, switch off
the tools you do not need in Cursor's MCP settings; the Drive tools
(drive_list_files, drive_download_file) and the scheduling tools
(list_scheduled, cancel_scheduled) are the usual first picks.
get_setup_summary returns a shareable markdown summary of what is set up
(domains, DNS state, mailboxes, what is still pending), for an agent to hand
to its human when it finishes.
Every tool declares readOnlyHint / destructiveHint, so clients can ask
before anything that sends or deletes.
What's in this repo
server.json: the official MCP Registry entry
.claude-plugin/ + .mcp.json: the Claude Code plugin and its marketplace
.cursor-plugin/ + mcp.json + rules/: the Cursor plugin (the rule is generated from the skill)
skills/faivelo-email/: an Agent Skill that teaches an agent to set up email on a domain, send from an app and verify inbound webhooks
gemini-extension.json + GEMINI.md: the Gemini CLI extension
assets/logo.svg: the Faivelo mark, for plugin listings
CHANGELOG.md: what changed in each plugin version
Don't have email on your domain yet?
bash
npx faivelo init yourdomain.com
Connects the domain, writes the DNS records (automatically on Vercel,
Cloudflare, Netlify and other supported hosts) and creates your mailboxes.
Plans start at $6/mo for unlimited mailboxes; forwarding is free.