English Français العربية

Faivelo Email

السجل الرسمي البحث والويب

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

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http faivelo-email 'https://faivelo.com/api/mcp'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "faivelo-email": {
            "type": "http",
            "url": "https://faivelo.com/api/mcp"
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. Faivelo Email MCP server
  2. Install
  3. Cursor
  4. Tools
  5. What's in this repo
  6. Don't have email on your domain yet?

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

ClientOne 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 DesktopSettings → 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 CodeInstall in VS Code
Codexcodex mcp add faivelo --url https://faivelo.com/api/mcp
Gemini CLIgemini extensions install https://github.com/ethannschwartz/faivelo-mcp
Windsurf{ "mcpServers": { "faivelo": { "serverUrl": "https://faivelo.com/api/mcp" } } } in mcp_config.json
Any Agent Skills clientnpx 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 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.

Tools

AreaTools
Readinglist_messages, read_message, get_thread, search_messages, search_all_mailboxes, list_folders, get_attachment, get_contacts
Sendingsend_message, send_batch (one templated email to many recipients, queued and paced server-side), get_batch_status, create_draft, update_draft, send_draft, list_scheduled, cancel_scheduled, get_delivery_status
Organisingflag_message, label_message, move_message, restore_message, mark_spam, mark_all_read, delete_message, empty_trash
Accountlist_mailboxes, create_mailbox, update_mailbox (set the name a mailbox sends as), get_account_summary, get_setup_summary, get_domain_setup (a domain's DNS records, found or missing), list_aliases, create_alias, delete_alias
Domains & DNSlist_domains, list_dns_records, create_dns_record, update_dns_record, delete_dns_record
Drivedrive_list_files, drive_download_file

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.

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?

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.

الأسئلة الشائعة

ما هو Faivelo Email؟

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

كيف أثبّت Faivelo Email؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http faivelo-email 'https://faivelo.com/api/mcp'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج Faivelo Email إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل Faivelo Email مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون Faivelo Email؟

ينشره ethannschwartz. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.