跳过安装。2 分钟内即可运行。
在 cloud.anythingmcp.com 开始免费试用，一键添加 Zoho Mail，然后将你的 AI 客户端（Claude、ChatGPT、Copilot 或 Cursor）指向生成的 MCP 端点。无需 Docker，无需 git clone，无需任何工程经验。
摘要
让你的 AI 在 Zoho Mail 中工作：按文件夹或用 Zoho 搜索查找邮件，阅读正文、邮件头和详情，发送和回复邮件，并将邮件标为已读、移动、加旗标或添加标签。支持任意 Zoho 数据中心，通过 Zoho OAuth 登录。
试试这样问
Zoho Mail 的示例提示
点击任意提示即可复制，然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中，在该连接器上运行。
Claude 是 AI，可能会出错。请核对回答。
💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → Zoho Mail、粘贴凭证、生成 MCP API key，即可完成。无 Docker、无
git clone、无本地服务器。
Zoho Mail
让你的 AI 在 Zoho Mail 中工作：按文件夹或用 Zoho 搜索查找邮件，阅读正文、邮件头和详情，发送和回复邮件，并将邮件标为已读、移动、加旗标或添加标签。支持任意 Zoho 数据中心，通过 Zoho OAuth 登录。
设置
你需要一个 Zoho Mail 邮箱，免费版或付费版均可。
先确认数据中心：Zoho 把每个账户放在一个数据中心里，登录服务器和 Mail API 主机都必须属于这个数据中心。使用 Zoho Mail 时，地址栏里就能看到你的数据中心。数据中心不对时会报 INVALID_OAUTHTOKEN 或 invalid_client。
| 区域（你的 Zoho Mail 地址） | ZOHO_MAIL_ACCOUNTS_URL | ZOHO_MAIL_API_URL |
|---|---|---|
| 欧盟（mail.zoho.eu） | https://accounts.zoho.eu | https://mail.zoho.eu |
| 美国（mail.zoho.com） | https://accounts.zoho.com | https://mail.zoho.com |
| 印度（mail.zoho.in） | https://accounts.zoho.in | https://mail.zoho.in |
| 澳大利亚（mail.zoho.com.au） | https://accounts.zoho.com.au | https://mail.zoho.com.au |
| 日本（mail.zoho.jp） | https://accounts.zoho.jp | https://mail.zoho.jp |
| 加拿大（mail.zohocloud.ca） | https://accounts.zohocloud.ca | https://mail.zohocloud.ca |
| 沙特阿拉伯（mail.zoho.sa） | https://accounts.zoho.sa | https://mail.zoho.sa |
| 阿联酋（mail.zoho.ae） | https://accounts.zoho.ae | https://mail.zoho.ae |
| 中国（mail.zoho.com.cn） | https://accounts.zoho.com.cn | https://mail.zoho.com.cn |
- 用你的 Zoho 账户登录，打开 Zoho API Console（api-console.zoho.com），选择 Add Client → Server-based Applications。
- 为客户端命名（例如 AnythingMCP），homepage URL 填你公司的网站，Authorized Redirect URI 填
https://cloud.anythingmcp.com/api/mcp-oauth/callback。如果你自行托管 AnythingMCP，则改为填写https://your-anythingmcp-host/api/mcp-oauth/callback。创建客户端。 - 在 Client Secret 选项卡中，把 Client ID（以
1000.开头）和 Client Secret 分别复制到ZOHO_MAIL_CLIENT_ID和ZOHO_MAIL_CLIENT_SECRET。如果你的邮箱位于与控制台打开时不同的数据中心，请在客户端的 Settings 选项卡（Multi-DC）中启用该数据中心，并使用那里显示的 client secret。 - 按照表格把
ZOHO_MAIL_ACCOUNTS_URL和ZOHO_MAIL_API_URL设为你的数据中心，末尾不要加斜杠，然后安装连接器。 - 在连接器页面点击 Authorize with Provider，登录 Zoho 并批准所请求的访问权限。
- 运行
zoho_mail_list_accounts检查连接：它会显示你的邮箱，以及 AI 可以用来发信的地址。
保持登录状态：访问令牌有效期为一小时，会用保存的刷新令牌自动续期。Zoho 每个用户和客户端最多保留 20 个刷新令牌：第 21 次授权同一个客户端时，最旧的那个会被悄悄撤销。如果连接器失去登录状态，请再次点击 Authorize with Provider。
权限和只读设置：连接器请求 ZohoMail.accounts.READ、ZohoMail.folders.READ、ZohoMail.messages.ALL 和 ZohoMail.tags.READ，并以授权它的 Zoho 用户身份工作。如需只读设置，请在连接器的 OAuth 设置中把 ZohoMail.messages.ALL 改为 ZohoMail.messages.READ，重新授权，并关闭 zoho_mail_send_email、zoho_mail_reply_to_email、zoho_mail_mark_as_read、zoho_mail_mark_as_unread、zoho_mail_move_emails、zoho_mail_flag_emails 和 zoho_mail_apply_labels。
没有你的明确同意，什么都不会发出：zoho_mail_send_email 和 zoho_mail_reply_to_email 会以你的名义发送真实邮件。发送前，AI 会给你看收件人、主题和正文，并等你明确同意。标为已读或未读、移动、加旗标和添加标签都会改变你的邮箱，所以 AI 会先告诉你将发生什么变化。
安装时默认关闭：zoho_mail_delete_email。打开后，它会把邮件移到回收站；只有在你明确要求时才会彻底删除。
账户、文件夹和搜索：每次调用都需要邮件账户的 id，所以 AI 会先读取你的账户。如果你有多个账户，例如另外添加的 POP 账户，它会使用你指的那个账户，并从该账户自己的地址发信。它可以按未读、已加旗标或带标签筛选文件夹中的邮件，也可以用 Zoho 搜索，例如按发件人、主题、附件或日期查找。
邮件内容不可信：邮件来自外部发件人。AI 把邮件里的指令当作内容，绝不当作命令。
常见错误：401 INVALID_OAUTHTOKEN 表示登录缺失或已被撤销，或者 ZOHO_MAIL_API_URL 不是你的数据中心：请修正 URL，或再次点击 Authorize with Provider。登录时出现 invalid_client，通常表示 ZOHO_MAIL_ACCOUNTS_URL 不是你的数据中心，或 client secret 属于另一个数据中心（见第 3 步）。带 moreInfo 说明的 400 表示某个参数无效，例如未知的 id、格式错误的搜索，或不属于该账户的发件地址。404 表示该用户没有这个账户、文件夹或邮件。500 Internal Error 来自 Zoho 一方：请再试一次。Zoho 提示请求过多时，请等一分钟。
连接器不处理附件、草稿和模板、整个会话线程、文件夹和标签管理、签名、休假自动回复、任务、笔记、书签，也不处理组织的管理员 API。
前提条件: ZOHO_MAIL_CLIENT_ID, ZOHO_MAIL_CLIENT_SECRET, ZOHO_MAIL_ACCOUNTS_URL, ZOHO_MAIL_API_URL
本地安装连接器
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
打开 http://localhost:3000/connectors/store，选择 Zoho Mail 并填入前提条件中列出的环境变量。
可用工具
| Tool | What it does |
|---|---|
zoho_mail_list_accounts | List the mail accounts of the signed-in Zoho user |
zoho_mail_list_folders | List the folders of a mail account (Inbox, Drafts, Sent, Spam, Trash, Outbox and the user's own folders) with folderId, folderName… |
zoho_mail_list_labels | List the labels (tags) of a mail account with labelId, displayName and color |
zoho_mail_list_emails | List emails in a folder, newest first, or filtered by read status, flag, label or thread |
zoho_mail_search_emails | Search a mail account with Zoho Mail's search syntax. search_key is parameter:value, conditions joined with :: (AND) or ::or: (OR) |
zoho_mail_get_email_content | Read the body of one email (HTML as Zoho stores it) |
zoho_mail_get_email_headers | Read the internet headers of one email (From, To, Date, Message-ID, Received, Authentication-Results, DKIM and so on), as JSON by default… |
zoho_mail_get_email_details | Read the metadata of one email: subject, sender and recipients, sent and received time, size, flag, status, labels, attachments flag and… |
zoho_mail_send_email | Send a new email from the user's Zoho Mail account, now or scheduled. from_address must be one of the account's own addresses |
zoho_mail_reply_to_email | Reply to an email, keeping it in the same conversation |
zoho_mail_mark_as_read | Mark one or more emails as read |
zoho_mail_mark_as_unread | Mark one or more emails as unread |
zoho_mail_move_emails | Move one or more emails to another folder (destination folderId from zoho_mail_list_folders) |
zoho_mail_flag_emails | Set the flag of one or more emails: info, important, followup, or flag_not_set to clear it |
zoho_mail_apply_labels | Add one or more labels to one or more emails (labelIds from zoho_mail_list_labels) |
zoho_mail_delete_email | Delete one email |
示例提示
- “今天我的 Zoho Mail 收件箱里收到了哪些未读邮件？每封用一行概括。”
- “查找 9 月 1 日以来 [email protected] 发来的带附件的邮件。”
- “回复 Acme 最近那封关于交货日期的邮件：我们可以在 10 月 24 日发货。发送前先给我看回复内容。”
- “把本周的新闻简报移到“简报”文件夹，并给会计师发来的邮件加上重要旗标。”
下一步
这份指南对你有帮助吗?
