Faivelo Email

Name: Faivelo Email
Author: faivelo

@faiveloMCP server · External

Business email on your own domain: mailboxes, send and read mail, aliases, DNS setup, and campaigns.

Email inboxv1.0.0MIT

Freeno charge per call

One address for any MCP client. You sign in at faivelo.com once, after adding it.

What it does

Reads
Writes
High impact

At most: moves money, runs code or commands, deletes data, or sends messages for you.

What it costs

Free

Odel charges nothing per call. The publisher may charge for its own service.

What it asks for at sign-in

Access to	Read	Change
Mailboxes
Mail

From the sign-in at faivelo.com, as the endpoint publishes it. You approve it there.

Tools

None listed · checked 11 Oct 2026

Odel could not list its tools without signing in.

Try it in the Inspector

README4 min readView on GitHub

Faivelo Email MCP server

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

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`
claude.ai / Claude Desktop	Settings → Connectors → Add custom connector → paste `https://faivelo.com/api/mcp`
Cursor (plugin: MCP + rule + skill)	`/add-plugin faivelo` in the agent chat, or Add to Cursor for the server alone (see Cursor)
VS Code	Install in VS Code
Codex	`codex mcp add faivelo --url https://faivelo.com/api/mcp`
Gemini CLI	`gemini extensions install https://github.com/ethannschwartz/faivelo-mcp`
Windsurf	`{ "mcpServers": { "faivelo": { "serverUrl": "https://faivelo.com/api/mcp" } } }` in `mcp_config.json`
Any Agent Skills client	`npx skills add ethannschwartz/faivelo-mcp` (the `faivelo-email` skill)
Other clients	`{ "mcpServers": { "faivelo": { "url": "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.

Tools

Area	Tools
Reading	`list_messages`, `read_message`, `get_thread`, `search_messages`, `search_all_mailboxes`, `list_folders`, `get_attachment`, `get_contacts`
Sending	`send_message`, `create_draft`, `update_draft`, `send_draft`, `list_scheduled`, `cancel_scheduled`, `get_delivery_status`
Organising	`flag_message`, `label_message`, `move_message`, `restore_message`, `mark_spam`, `mark_all_read`, `delete_message`, `empty_trash`
Account	`list_mailboxes`, `create_mailbox`, `get_account_summary`, `get_setup_summary`, `list_aliases`, `create_alias`, `delete_alias`
Domains & DNS	`list_domains`, `list_dns_records`, `create_dns_record`, `update_dns_record`, `delete_dns_record`
Drive	`drive_list_files`, `drive_download_file`

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.

Website: https://faivelo.com/ai-agents?via=mcp
Docs: https://faivelo.com/docs/developers/connect-claude/?via=mcp
Node SDK: npm install faivelo · Python SDK: pip install faivelo

Similar modules

Browse Email inbox