Connects domains hosted on Cloudflare to Faivelo's email setup, automatically writing the DNS records (MX, SPF, DKIM, etc.) needed to receive mail. The server also exposes tools to list, create, update and delete DNS records for those domains.
Connects domains hosted on Netlify to Faivelo's email setup, automatically writing the DNS records required for email on the domain. The server also exposes tools to list, create, update and delete DNS records for those domains.
Connects domains hosted on Vercel to Faivelo's email setup, automatically writing the DNS records required for email on the domain. The server also exposes tools to list, create, update and delete DNS records for those domains.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Faivelo Email MCP Server summarize my unread emails and draft replies"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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/mail
Access: a Faivelo account. MCP is included on Growth and up, and in the
free trial (no card). Plans
Client | One command |
Claude Code (plugin: MCP + skill) |
|
Claude Code (MCP only) |
|
claude.ai / Claude Desktop | Settings → Connectors → Add custom connector → paste |
Cursor (plugin: MCP + rule + skill) |
|
VS Code | |
Codex |
|
Gemini CLI |
|
Windsurf |
|
Any Agent Skills client |
|
Other clients |
|
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.
Related MCP server: lenovmail
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 34 tools on an OAuth connection
(38 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.
Area | Tools |
Reading |
|
Sending |
|
Organising |
|
Account |
|
Domains & DNS |
|
Drive |
|
send_message and send_batch take from as "bot@yourdomain.com" or
"Support Bot <bot@yourdomain.com>"; a name there (or fromName) is the
From name for that message only. Give each mailbox a lasting name with
displayName on create_mailbox or with update_mailbox; a send from a
mailbox with no name anywhere returns a hint saying so.
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.
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
npx faivelo init yourdomain.comConnects 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.
Docs: https://faivelo.com/docs/developers/connect-claude/?via=mcp
Node SDK: npm install faivelo · Python SDK: pip install faivelo
This server cannot be deployed
Real email for AI agents: domains, mailboxes, a unified inbox, wait-for-code, send and reply.
Give AI agents their own email inboxes: list, read and send mail via scoped, revocable OAuth grants.
Email inboxes for AI agents: send, receive, search, drafts with owner approval, and webhooks.
Give an AI agent its own inbox — receive email as a webhook, send over a verified domain.