Faivelo Email

Faivelo Email MCP 服务

让 Claude、ChatGPT、Cursor、Codex 或任何 AI Agent 都能在你自己的域名下使用真实的电子邮箱。你的助手可以读取和搜索邮件、起草并发送回复、安排发送时间、归档邮件、为自己创建新地址，还能修复你的域名 DNS。你可以精确选择它能访问哪些邮箱。

适用于以下场景：

• 让你的编码 Agent 为它刚构建的网站设置 [email protected]
• 为 AI Agent 提供自己的邮箱地址，用于注册服务和接收验证码
• 通过 Claude 对支持邮箱进行分类、总结和回复
• 无需打开邮件应用，即可从你的真实邮箱地址发送回复

服务 URL： https://faivelo.com/api/mcp（可流式传输的 HTTP、OAuth 2.1，无需粘贴 API 密钥） 注册表名称： com.faivelo/mail 访问权限： 需要 Faivelo 账户。Growth 及以上套餐和免费试用版（无需信用卡）均包含 MCP。套餐

安装

客户端	一条命令
Claude Code（插件：MCP + 技能）	/plugin marketplace add ethannschwartz/faivelo-mcp 然后运行 /plugin install faivelo@faivelo
Claude Code（仅 MCP）	claude mcp add --transport http faivelo https://faivelo.com/api/mcp
claude.ai / Claude Desktop	设置 → 连接器 → 添加自定义连接器 → 粘贴 https://faivelo.com/api/mcp
Cursor（插件：MCP + 规则 + 技能）	在 Agent 聊天中运行 /add-plugin faivelo，或者通过 添加到 Cursor 仅添加服务（参见 Cursor）
VS Code	在 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	在 mcp_config.json 中填写 { "mcpServers": { "faivelo": { "serverUrl": "https://faivelo.com/api/mcp" } } }
任何 Agent Skills 客户端	npx skills add ethannschwartz/faivelo-mcp（faivelo-email 技能）
其他客户端	{ "mcpServers": { "faivelo": { "url": "https://faivelo.com/api/mcp" } } }

首次调用时会打开浏览器供你登录，你可以精确选择助手能够访问哪些邮箱。

无头 Agent（无浏览器）：改为发送 API 密钥， Authorization: Bearer fvl_live_...。在 设置 → 开发者创建 Agent 密钥；它只能访问由其创建或授权给它的邮箱。

Cursor

两种接入方式。首次调用时，两者都会通过浏览器登录；无需粘贴密钥。

• 插件（在 Cursor Marketplace 上架后）：在 Agent 聊天中输入 /add-plugin faivelo，或在设置 → 插件中找到 Faivelo。该插件会安装 MCP 服务、 faivelo-email 技能，以及一条规则，指导 Agent 如何为域名设置电子邮件、从应用发送邮件并验证 Webhook。
• 仅服务：添加到 Cursor， 或将 { "mcpServers": { "faivelo": { "url": "https://faivelo.com/api/mcp" } } } 放入 .cursor/mcp.json（当前项目）或 ~/.cursor/mcp.json（所有项目）。 无头设置请添加 "headers": { "Authorization": "Bearer fvl_live_..." }。

Cursor 在你启用的所有 MCP 服务中，最多会向模型提供大约 40 个工具。 Faivelo 在 OAuth 连接上提供 30 到 34 个工具 （使用 API 密钥时为 38 个），因此如果同时运行其他服务，请在 Cursor 的 MCP 设置中关闭不需要的工具；Drive 工具 （drive_list_files、drive_download_file）和定时工具 （list_scheduled、cancel_scheduled）通常是优先关闭的选项。

工具

区域	工具
读取	list_messages、read_message、get_thread、search_messages、search_all_mailboxes、list_folders、get_attachment、get_contacts
发送	send_message、send_batch（向多个收件人发送一封模板邮件，由服务端排队并控制发送节奏）、get_batch_status、create_draft、update_draft、send_draft、list_scheduled、cancel_scheduled、get_delivery_status
整理	flag_message、label_message、move_message、restore_message、mark_spam、mark_all_read、delete_message、empty_trash
账户	list_mailboxes、create_mailbox、update_mailbox（设置邮箱发送时使用的名称）、get_account_summary、get_setup_summary、get_domain_setup（域名的 DNS 记录，包括已找到或缺失的记录）、list_aliases、create_alias、delete_alias
域名与 DNS	list_domains、list_dns_records、create_dns_record、update_dns_record、delete_dns_record
云端硬盘	drive_list_files、drive_download_file

send_message 和 send_batch 的 from 参数可填写 "[email protected]" 或 "Support Bot <[email protected]>"；其中的名称（或 fromName）仅是该邮件的发件人名称。使用 create_mailbox 的 displayName 或 update_mailbox 为每个邮箱设置长期名称；如果发送邮件时邮箱没有设置任何名称，响应会返回说明这一情况的 hint。

get_setup_summary 会返回一份可分享的 Markdown 摘要，列出已完成的设置（域名、DNS 状态、邮箱及仍待处理的事项），供 Agent 在任务完成后交给使用者。

每个工具都会声明 readOnlyHint / destructiveHint，因此客户端可以在执行发送或删除操作前征求确认。

此仓库包含的内容

• server.json：官方 MCP Registry 条目
• .claude-plugin/ + .mcp.json：Claude Code 插件及其市场配置
• .cursor-plugin/ + mcp.json + rules/：Cursor 插件（规则由技能生成）
• skills/faivelo-email/：一项 Agent Skill，指导 Agent 如何为域名设置电子邮件、从应用发送邮件并验证入站 Webhook
• gemini-extension.json + GEMINI.md：Gemini CLI 扩展
• assets/logo.svg：Faivelo 标志，用于插件列表
• CHANGELOG.md：各插件版本的变更记录

你的域名还没有电子邮件服务？

npx faivelo init yourdomain.com

连接域名、写入 DNS 记录（在 Vercel、 Cloudflare、Netlify 和其他受支持的托管平台上可自动完成），并创建邮箱。 套餐起价为每月 6 美元，邮箱数量不限；邮件转发免费。

• 网站：https://faivelo.com/ai-agents?via=mcp
• 文档：https://faivelo.com/docs/developers/connect-claude/?via=mcp
• Node SDK：npm install faivelo · Python SDK：pip install faivelo