yt-zoho-mcp

用于 Zoho Mail 的 MCP 服务器 —— 跨文件夹搜索、读取、发送和管理邮件。

实现了 Model Context Protocol 规范：通过 stdio 传输运行，使用 JSON-RPC 2.0 通信，在 initialize 时协商协议版本，声明 tools 能力，并用 JSON Schema 描述每个工具。协议版本协商由 @modelcontextprotocol/sdk 的 Server 类处理，默认使用最新支持的版本。

工具

Related MCP server: zoho-mail-mcp

设置

1. 创建 Zoho Mail API 客户端

1. 前往 Zoho API 控制台

2. 创建 自助客户端（或基于服务器的应用）

3. 复制 client_id 和 client_secret

4. 使用 离线 作用域生成 OAuth 令牌，以获取 refresh_token：

   virtualoffice.accounts.read
   virtualoffice.messages.read
   virtualoffice.messages.create
   virtualoffice.messages.update
   virtualoffice.messages.delete

5. 通过 获取账户 端点查找您的 account_id，并记下您的邮箱地址（例如 you@example.com）。

2. 放置凭据

安装该包后，会自动通过 postinstall 脚本创建配置目录 ~/.yt-zoho-mcp（以 npm 包命名）。将 credentials.json 放入其中：

{
  "clientId": "...",
  "clientSecret": "...",
  "refreshToken": "...",
  "accountId": "...",
  "email": "you@example.com"
}

服务器会在每次调用时自动从 refreshToken 刷新访问令牌（并在收到 401 时重新刷新）。

配置

MCP 主机配置

opencode

{
  "mcp": {
    "zoho-mail": {
      "type": "local",
      "command": ["npx", "yt-zoho-mcp"]
    }
  }
}

Claude Desktop

{
  "mcpServers": {
    "zoho-mail": {
      "command": "npx",
      "args": ["yt-zoho-mcp"]
    }
  }
}

许可证

MIT