快速接入

先看主来源和安装命令，再打开仓库或文档；下面只保留这个条目的关键接入事实。

详细介绍

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

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提示和嵌入式技能仅记录此存储库中由实时工具支持的工作流。

验证

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

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的认可。

目录标签

命令行工具办公自动化RustClaude本地部署Zoho集成MCP服务器多账户管理

支持客户端

ClaudeCursor

接入字段

传输方式（transport，传输协议）

未说明

鉴权方式（authType，认证方式）

oauth

工具数量（toolCount，工具数）

0

资源数量（resourceCount，资源数）

0

提示词数量（promptCount，提示词数）

0

权限和风险

未说明oauth部署方式未说明

接入前请确认传输方式、认证方式和部署位置，并根据实际工具能力限制访问范围。

安装前确认

不要直接授予不必要的文件、网络或账号权限；先核对安装命令和配置内容。

仍需确认：installCommand

来源信息

MCP World

mcpworld.com

/detail/7f417789e569a02ba67e05209576fd4b

为Zoho Mail、Zoho Calendar和Zoho WorkDrive提供统一的命令行接口、MCP服务器和应用程序集成。

继续浏览同类 MCP

更多开发工具 MCP（20,396）返回 MCP 目录

上一个 MCP

Zmzhace MCP

A feature-rich Model Context Protocol server built with FastMCP that provides various tools including basic utilities, network services, file operations, encryption tools, and system information functions.

下一个 MCP

Zoekt MCP

Zoekt MCP Server是一个基于Zoekt索引代码搜索引擎的模型上下文协议服务器，提供跨代码库的高级搜索功能，适用于AI助手和开发工具。

zocli (Next Stat)