zocli (Next Stat)

zocli

CLI, MCP server, and MCP Apps for Zoho Mail, Zoho Calendar, and Zoho WorkDrive

One product-grade interface for terminals, AI agents, and MCP hosts.

Installation • Quick Start • Commands • MCP • Accounts

zocli 将Zoho Mail、Zoho Calendar和Zoho WorkDrive连接起来，为人类和代理提供一份干净的合同。相同的二进制文件涵盖了日常终端工作、面向代理的MCP集成和托管的MCP应用程序，而不强制每个客户端学习三个不同的服务API。

CLI for daily operations

Accounts, mail, calendars, and WorkDrive commands in one binary and one config directory.

MCP for agents

A real MCP server with stdio and http transports, prompts, embedded skills, resources, completions, and hosted app metadata.

MCP Apps for UI hosts

Dashboard, deep links, prompt catalog, resource browser, and capability-aware discovery inside MCP-capable clients.

安装

macOS和Linux

curl -fsSL https://raw.githubusercontent.com/NextStat/zocli/main/scripts/install.sh | sh

视窗

irm https://raw.githubusercontent.com/NextStat/zocli/main/scripts/install.ps1 | iex

macOS的预构建二进制文件 x86_64/arm64，Linux x86_64/arm64，以及Windows x86_64 发表于 .

From source / update / private mirror

cargo install --path .
zocli update
zocli update --check

对于私有版本镜像：

export ZOCLI_UPDATE_BASE_URL='https://mirror.example.test/releases/download/v0.2.4'
zocli update --check

快速开始

安装 zocli，注册一个Zoho帐户，进行一次身份验证，并验证核心表面：

curl -fsSL https://raw.githubusercontent.com/NextStat/zocli/main/scripts/install.sh | sh
zocli add me@zoho.com
zocli login
zocli mcp install --client claude

如果您的Zoho帐户位于默认值之外 com 数据中心，在帐户设置过程中明确传递它，例如：

zocli add me@company.com --datacenter eu

然后验证运行时：

zocli status
zocli mail folders
zocli calendar calendars
zocli drive info

你立即得到的：

• Zoho Mail、Calendar和WorkDrive的本地CLI；
• 用于Claude、Codex、Gemini、Cursor和其他兼容客户端的MCP服务器；
• MCP应用程序的嵌入式提示、技能、资源和托管仪表板；
• 一个稳定的发现面 zocli guide.

从指南开始

zocli guide 是稳定CLI合约的真实来源：

zocli guide
zocli guide --topic mail
zocli guide --topic calendar
zocli guide --topic drive

日常命令

帐户和身份验证

zocli add me@zoho.com
zocli accounts
zocli use work
zocli whoami
zocli status
zocli login
zocli logout mail

• add 除非您明确传递，否则从电子邮件中获取帐户别名。
• add 不再需要 account_id; zocli login auto在第一个成功的OAuth流后发现它。
• add 可以自动使用共享/默认的zocli OAuth应用程序。使用 --client-id 和 --client-secret 仅作为高级覆盖。
• --datacenter 非事项-com Zoho账户。有效值为 com, eu, in, com.au, jp, zohocloud.ca, sa，以及 uk.
• login 对Zoho OAuth2进行身份验证 mail, calendar，以及 drive 除非你将其限定为一项服务。
• --profile 可以在任何服务命令上覆盖当前帐户。

邮件

zocli mail folders
zocli mail list --limit 10
zocli mail search "invoice"
zocli mail read --folder-id 1111111111111111111 2222222222222222222
zocli mail send person@example.com "Meeting" "See you at 3pm"
zocli mail send person@example.com "Report" "Attached." --attachment ./report.pdf
zocli mail reply --folder-id 1111111111111111111 2222222222222222222 "Got it, thanks"
zocli mail forward --folder-id 1111111111111111111 2222222222222222222 person@example.com "FYI"

• mail read, mail reply，以及 mail forward 需要文件夹ID和邮件ID。
• mail search 是在读取或回复之前发现消息ID的最快方法。
• mail send 支持文本、HTML， cc, bcc，并重复 --attachment 旗帜。

日历

zocli calendar calendars
zocli calendar events
zocli calendar events 2026-03-16 2026-03-23 --limit 20
zocli calendar create "Team Sync" 2026-03-16T09:00:00Z 2026-03-16T10:00:00Z
zocli calendar delete 

• 在没有明确日期的情况下， events 默认为接下来的30天。
• --calendar 以非默认日历为目标。

工作驱动器

zocli drive info
zocli drive list
zocli drive list  --limit 50
zocli drive upload ./report.pdf 
zocli drive download  --output ./report.pdf

• drive list 如果没有文件夹ID，则列出可用的团队/工作区。
• WorkDrive操作使用ID，而不是类似路径的虚拟位置。
• drive download 需要 --output，以及 --force 允许覆盖现有文件。

主控程序

运行服务器

zocli mcp
zocli mcp --transport http --listen 127.0.0.1:8787
zocli mcp --transport http --listen 127.0.0.1:8787 --public-url https://mcp.example.com/zocli

stdio 适用于传统的本地MCP主机。 http 为支持远程MCP服务器和UI资源的主机添加流式HTTP加SSE通知。

安装到支持的客户端

zocli mcp install
zocli mcp install --client claude --client codex --client gemini

安装程序注册MCP服务器并写入嵌入式技能，目标客户端在其中显示技能界面。

MCP客户端可以获得什么

• 帐户和身份验证工具；
• 邮件、日历和WorkDrive工具，包括 zocli.mail.attachment_export;
• 托管仪表板位于 ui://zocli/dashboard;
• 嵌入式提示和技能资源；
• 帐户、日历和仪表板视图的完成提示。

多账户

zocli 账户优先。一个活期账户在您切换之前保持活动状态。

zocli add personal@zoho.com
zocli add work@zoho.com
zocli use work
zocli login
zocli use personal
zocli mail list --limit 5
zocli use work
zocli mail list --limit 5

每个帐户都保留自己的凭据和服务状态。使用 --profile 当您需要在不全局切换当前帐户的情况下进行显式覆盖时。

为什么选择zocli

局限性

• 从邮件导入日历邀请不是当前稳定公共界面的一部分。
• 可通过MCP工具导出邮件附件 zocli.mail.attachment_export；没有单独的CLI命令。
• WorkDrive使用真实的文件夹ID和文件ID，而不是虚拟的 disk:/... 路径层。
• MCP提示和嵌入式技能仅记录此存储库中由实时工具支持的工作流。

验证

存储库为公共表面提供了一个稳定的产品入口：

cargo build --workspace
cargo test --workspace
cargo clippy --workspace --all-targets -- -D warnings
sh ./scripts/smoke-product-surface.sh target/debug/zocli

免责声明

zocli 是NextStat的一个独立开源项目。它不是Zoho的官方产品，也没有得到Zoho的认可。