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```bash
curl -fsSL https://raw.githubusercontent.com/NextStat/zocli/main/scripts/install.sh | sh
### 视窗```powershell
irm https://raw.githubusercontent.com/NextStat/zocli/main/scripts/install.ps1 | iex
macOS的预构建二进制文件 x86_64/arm64,Linux x86_64/arm64,以及Windows x86_64 发表于 GitHub 发布.
From source / update / private mirror```bash
cargo install --path .
zocli update
zocli update --check
对于私有版本镜像:```bash
export ZOCLI_UPDATE_BASE_URL='https://mirror.example.test/releases/download/v0.2.4'
zocli update --check
快速开始
安装 zocli,注册一个Zoho帐户,进行一次身份验证,并验证核心表面:```bash
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` 数据中心,在帐户设置过程中明确传递它,例如:```bash
zocli add me@company.com --datacenter eu
然后验证运行时:```bash
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合约的真实来源:```bash
zocli guide
zocli guide --topic mail
zocli guide --topic calendar
zocli guide --topic drive
日常命令
帐户和身份验证```bash
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 ` 可以在任何服务命令上覆盖当前帐户。
### 邮件```bash
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旗帜。
日历```bash
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 ` 以非默认日历为目标。
### 工作驱动器```bash
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允许覆盖现有文件。
主控程序
运行服务器```bash
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通知。
### 安装到支持的客户端```bash
zocli mcp install
zocli mcp install --client claude --client codex --client gemini
安装程序注册MCP服务器并写入嵌入式技能,目标客户端在其中显示技能界面。
MCP客户端可以获得什么
- 帐户和身份验证工具;
- 邮件、日历和WorkDrive工具,包括
zocli.mail.attachment_export; - 托管仪表板位于
ui://zocli/dashboard; - 嵌入式提示和技能资源;
- 帐户、日历和仪表板视图的完成提示。
多账户
zocli 账户优先。一个活期账户在您切换之前保持活动状态。```bash
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
|Surface |它给你什么|
| --- | --- |
| `One runtime` |邮件、日历和WorkDrive位于一个二进制文件、一个配置界面和一个发现契约中。 |
| `MCP-native` |该仓库将CLI命令、MCP工具、资源、提示和托管应用程序元数据一起提供。 |
| `Ship-ready` |发布打包、安装程序、Homebrew配方生成、Winget清单和冒烟脚本都是仓库的一部分。 |
| `Agent-friendly` | `zocli guide`结构化JSON输出和MCP提示减少了AI客户端的编排开销。 |
## 局限性
- 从邮件导入日历邀请不是当前稳定公共界面的一部分。
- 可通过MCP工具导出邮件附件 `zocli.mail.attachment_export`;没有单独的CLI命令。
- WorkDrive使用真实的文件夹ID和文件ID,而不是虚拟的 `disk:/...` 路径层。
- MCP提示和嵌入式技能仅记录此存储库中由实时工具支持的工作流。
## 验证
存储库为公共表面提供了一个稳定的产品入口:```bash
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的认可。
