Corresync

Corresync

邮件、日历和任务。一个本地 MCP 服务和命令行工具。
面向 AI Agent、脚本和你自己的中立于服务提供商、本地优先工具。

网站 · 快速入门 · 服务提供商 · 功能 · 安全 · 隐私 · 条款 · 技术文档

corr 将彼此隔离的邮件、日历和任务账户汇集到一个终端中，也汇集到一个本地的 Model Context Protocol 服务中。 Gmail、Google Calendar 和 Google Tasks 可通过你掌控的 Google Cloud 项目中的桌面 OAuth 客户端使用。由 Corresync 管理的 Google OAuth 仍处于休眠状态。规范的任务工具也包含明确的 Microsoft To Do、Todoist、TickTick 和 CalDAV VTODO 路由；在相应契约实现之前，其余任务服务提供商适配器仍不可用。

• 跨账户搜索邮件并汇总日程，同时保留账户身份和服务提供商来源信息。
• 随着服务提供商适配器陆续可用，使用一个稳定且保留来源信息的任务模型。
• 保存私有的账户级邮件搜索和相对日历时间范围，然后实时运行，无需创建影子邮箱或日历缓存。
• 通过易于使用的命令行工具、稳定的 JSON 或 AI Agent，使用相同的类型化操作。
• 在可见的浏览器中完成登录，使用明确的公共客户端 OAuth 流程，或使用经批准的本地凭据存储。
• 在重要操作生效前先进行审查。远程结果未知时会停止操作以供核对，而不会自动重试。

使用体验

$ corr mail search --all-accounts \
    --query 'subject:"Quarterly plan"' --limit 3
● work · microsoft-owa   Ana Ruiz   Plan review
· personal · jmap       Finance    Plan receipt

$ corr agenda list --all-accounts \
    --start 2026-07-29T00:00:00Z \
    --end 2026-07-30T00:00:00Z

将 Agent 连接到同一个本地核心：

corr integrations detect
corr integrations plan codex claude-code
corr integrations setup codex claude-code
# Phase A also includes github-copilot, gemini-cli, qwen-code, qoder, kimi-code

然后自然地提出请求：

Check my inboxes, calendars, and task lists and summarize what needs attention today.

某个服务提供商失败时会明确报告为部分失败。成功结果仍然可用，写入操作仍要求指定一个确切的账户。

选择适合的路线

邮件、日历和任务路线分别选择。例如，一个账户可以将 IMAP/SMTP 邮件与 CalDAV 日历搭配使用；任务路线仍需单独明确选择。

路线	邮件	日历	任务	身份验证
Outlook Web	类型化读取和写入	可选日历；提供商支持的 Teams 链接	—	专用的可见浏览器配置文件
Google（你的 OAuth 客户端）	Gmail API 读取和写入；不支持永久删除	可选日历；提供商公布时支持 Google Meet	通过单独的仅限任务授权使用 Google Tasks	你的 Desktop OAuth 客户端；客户端凭据和授权存储在操作系统密钥环中
Microsoft Graph	类型化读取和写入	可选日历；类型化创建 Teams 链接	Microsoft To Do	你授权的公共 OAuth 客户端；授权存储在操作系统密钥环中
Todoist	—	—	类型化 Todoist 操作	你授权的公共 OAuth 客户端；授权存储在操作系统密钥环中
TickTick	—	—	类型化 TickTick 操作	你授权的机密 OAuth 客户端；外部密钥句柄和存储在操作系统密钥环中的授权
JMAP	类型化邮件操作	—	—	操作系统密钥环或经批准的凭据助手
IMAP / SMTP	IMAP 读取/管理和 SMTP 草稿/发送	—	—	操作系统密钥环或经批准的凭据助手
CalDAV	—	类型化日历操作和条件式排期	VTODO 列表、搜索、同步和经审核的写入	操作系统密钥环或经批准的凭据助手

发现过程会收集 DNS、well-known 和提供商元数据，不需要凭据。 它不会进行身份验证或添加账户。Microsoft Graph 和用户自有的 Google 授权仍需明确选择，绝不会作为自动回退方案。Google 发现过程可以提供 引导式 Desktop 客户端设置，但只有在之后明确执行 corr auth login 时才会开始 Google 登录。请参阅带注释的 Google 设置指南。

iCloud 提供一流的引导式预设，基于相同的提供商中立 IMAP/SMTP 和 CalDAV 适配器。 corr setup 可识别文档记录的 iCloud Mail 地址系列或完整且已验证的 Apple SRV 端点集， 将两条路线作为一个账户一并审核，并默认使用一个外部凭据句柄。 添加账户后，可通过明确的交接打开 Apple 的 App 专用密码页面和操作系统提供的凭据提示； corr 进程绝不会读取 App 专用密码。

上述所有可用的 v0.9 路线都有合成的提供商契约和应用覆盖测试。 用户自有的 Google API 路线可用，但尚未经过实时观察。其他提供商和平台实现 在将经授权且不含内容的观察结果绑定到确切提交之前，仍为 未经实时观察。连接敏感账户前，请参阅兼容性证据。

从安装到首次读取

更喜欢引导页面？请参阅 网站上的入门指南。

1. 安装

官方独立安装程序是在所有平台上最快捷的方式。 它们会选择最新的稳定版本，验证其压缩包和候选二进制文件， 以当前用户身份安装且无需提升权限，并且不会触碰账户设置。

macOS 和 Linux

curl -LsSf https://corresync.org/install.sh | sh
corr --version

Windows PowerShell

powershell -NoProfile -Command "irm https://corresync.org/install.ps1 | iex"
corr --version

如果您愿意，可以先查看 install.sh 或 install.ps1，再运行安装程序。包管理器也始终是完全受支持的替代方案：

# Homebrew · macOS or Linux
brew install nkiyohara/corresync/corresync

# WinGet · Windows
winget install --id nkiyohara.Corresync --exact

# Scoop · Windows
scoop bucket add corresync https://github.com/nkiyohara/scoop-corresync
scoop install corresync/corresync

直接下载归档文件、原生 Linux 软件包、版本固定、校验和以及 Sigstore 来源证明，请参阅安装指南。对于不常使用 GitHub 的用户，引导式网站会持续显示相同的复制粘贴选项。

Claude Desktop 用户也可以从最新版本安装适用于所有平台的 .mcpb。该捆绑包会在本地通过 stdio 运行同一个经验证的 corr mcp serve 二进制文件；它不会部署 Corresync，也不会中继邮箱数据。请先安装 CLI，以完成下方明确列出的账户设置和登录步骤，然后在 Claude Desktop 中打开或拖入 .mcpb。

保持更新

交互式命令会在启动时安静地检查缓存中的版本信息。如果有更新，Corresync 会显示适用于您安装方式的确切命令：独立版本使用 corr update，或使用对应的 Homebrew、Scoop 或 WinGet 命令。Corresync 绝不会修改由包管理器管理的文件。

默认选择稳定版。希望使用已签名候选版本的独立版本用户，可以通过交互方式选择预览通道：

corr settings

脚本中可使用以下等效的复制粘贴命令：

corr config set updates.channel preview
corr update

使用 corr config set updates.channel stable 切换回来；Corresync 绝不会将正在运行的二进制文件降级。预览版本不会进入包管理器目录。

新的独立版本配置会启用经验证的自动安装。现有配置会保留原有设置；如需启用，请显式运行：

corr config set updates.auto_install true

自动安装不会在 MCP 工具调用、配置更改、守护进程任务、JSON 输出、管道或其他非交互路径中运行。交互运行时，直接执行 corr 也会进行检查。验证完成后，更新程序会停止并重启当前会话所有者，并使用已更新的可执行文件运行所请求的命令。0.9.2 版本的所有者也会在外部可执行文件被替换后，于已准入的操作完成时退出。运行 corr config set updates.auto_install false 可禁用自动安装。

2. 添加账户并登录

corr setup

引导式设置会根据当前本地状态生成可恢复的预检，可选择在显示的用户本地路径安装 shell 补全，然后执行无需凭据的账户发现。它会预览所选的邮件、日历和任务路由，并且只会在确认后添加账户。身份验证或访问外部凭据仍是单独的选项。同一次运行还可以添加更多账户、选择多个检测到的 Agent 主机、预览各自独立的本地集成计划、仅应用一个已确认的计划，并验证每项结果。重新运行 corr setup 会跳过已正常完成的步骤，并提供缺失或可修复的步骤。

选择连接路由后，向导会显示服务清单。对于 Microsoft 账户，Outlook Mail 和 Calendar 默认预选，且可分别更改；Microsoft To Do 是可选项，需要明确授权 Graph。Teams 消息功能可通过 Teams Web 作为预览选用，也可明确授权 Graph。Mattermost 也可作为预览选用；这些路由的实时兼容性证据仍不完整。发现结果只能作为路由依据：它无法证明任何已勾选的服务已为该账户启用，也不会触发 Graph 回退。 运行 corr settings 可打开相同的账户向导；通过方向键表单登录、重命名、 选择或移除账户，并管理更新、安全设置和浏览器登录。其“设置”指南入口会恢复完整的协调器， 而不是维护另一套实现。顶层“账户”类别包含“添加账户”和已配置的账户 列表；选择账户后，只会显示该账户的操作。移除前会预览将删除的本地数据并请求确认；如果移除默认账户， 会先询问要由哪个剩余账户接替。每个选项还会显示对应的命令，因此交互流程也能教你直接使用 CLI。 设置 CORRESYNC_ACCESSIBLE=true 可启用面向屏幕阅读器的逐行提示；输入 :cancel 可安全退出输入步骤。直接重命名表单仍为：

corr account rename personal work

脚本和高级用户仍可使用确定性的表单：

corr setup [email protected] --alias personal
corr auth login --account personal
corr doctor --account personal

直接使用 setup ADDRESS 表单会创建相同的、与提供商无关且不含密钥的 本地配置，执行无需凭据的发现，并且只添加可自动选择的第一方路由。它绝不会打开登录页面。 身份验证是单独的、针对特定账户的操作。

如果无法安全地选择路由，或者你想使用 API 或标准路由， 请检查证据并选择确切的提供商设置：

corr account discover [email protected]
corr account add [email protected] --help

对于 Gmail、Google Calendar 和 Google Tasks，请在你控制的 Google Cloud 项目中创建桌面版 OAuth 客户端。引导式设置会验证下载的 客户端 JSON，并将生成的凭据存入操作系统密钥环；添加账户仍不会进行身份验证。请参阅 Google OAuth 设置指南，了解当前 Cloud Console 界面、受众选项、确切的 API、作用域、导入和登录步骤。

安装前，可选的 提供商兼容性检查器 可以根据公开证据对地址进行分类。浏览器仅会在请求正文中发送 @ 后面的域名；它绝不会发送本地 部分、保存地址或启动登录。该公共服务仅使用固定的 DNS 解析器，不会返回原始 DNS 记录。 如果你愿意，可以跳过此步骤，直接在本地运行 corr account discover ADDRESS。

添加账户不会进行身份验证。OAuth 路由需要你获准使用的客户端注册信息。 此外，Google 还需要为其生成的桌面客户端凭据单独提供外部句柄。 标准路由使用密钥环条目 或明确批准的辅助程序引用。密码和令牌绝不会写入 config.toml。请参阅账户和提供商配置。 Outlook Web 路由会在之后执行 auth login 时打开专用的可见配置文件窗口；该窗口会一直保留为由浏览器管理的会话，直到账户 注销或守护程序关闭。SSO、MFA、Conditional Access 和组织通知仍由提供商管理的流程处理。

3. 连接 Agent

corr mcp setup codex

使用 corr mcp --help 查看适用于 Claude Code、GitHub Copilot CLI、Gemini CLI、Qwen Code、Qoder、Kimi Code CLI 和通用 stdio 客户端的说明。Corresync 提供 45 个 精简工具和两个只读监控资源；它不提供 HTTP、SSE、 远程 MCP 端点或托管中继。

首次尝试不会发送

影响重大的写入操作采用服务器强制执行的 preview -> commit 协议。第一条命令会显示规范化后的账户、提供方、目标、收件人、内容摘要和版本前置条件，但不会执行操作。

printf 'Synthetic body.\n' | \
  corr mail send \
    --account work \
    --to [email protected] \
    --subject 'Review example' \
    --body-file -

检查所有字段后，使用批准信息重复执行完全相同的命令：

printf 'Synthetic body.\n' | \
  corr mail send \
    --account work \
    --to [email protected] \
    --subject 'Review example' \
    --body-file - \
    --approve

批准信息有效期短、仅能使用一次，并且绑定到调用方、账户、提供方、目标、载荷和操作。任何已审核字段的变更都会使其失效。MCP 将预览和提交设为两个独立的强类型工具。

查看完整的安全模型。 Corresync 的公开隐私政策 说明了 Google 数据访问、本地存储、披露、保留和移除方式；使用条款保留了 Apache-2.0 赋予的软件权利。

不止一个收件箱

• **跨账户视图：**范围受限的邮件搜索和日程投影会保留原始账户、提供方、日历、时区以及部分失败的来源信息。
• **只读导入暂存：**检查明确批准的本地归档、Maildir 目录树或受支持的导出文件，不会上传或修改源数据。
• **选择加入的监控：**按需从 off 逐步启用本地通知、持久化队列，最后启用一个经批准且不使用 shell 的运行器。远程外传需要单独同意。
• **保护隐私的反馈：**在本地生成允许列表报告，检查后再明确复制、保存或打开预填的 GitHub 页面。另有一项默认关闭的独立设置：在交互式操作失败后，可通过已认证的 gh 客户端提交内容更少、仅包含允许列表项的公开问题报告。

邮箱、日历、导入和事件队列中的值属于私密且不可信的外部数据。其内容绝不会成为运行命令或启动 Agent 的授权依据。

明确的边界

• Gmail、Google Calendar 和 Google Tasks 需要用户自有的 Google Desktop OAuth 客户端。Corresync 管理的 Google OAuth 保持禁用；用户自有的授权路径已通过合成契约测试，但未经实时验证。
• Microsoft Graph 需要你自行授权的公共客户端注册。Corresync 不提供令牌中继。
• 由于 Corresync 不会安装 AppUserModelID，因此无法设置 Windows 桌面通知；队列和经批准的运行器模式仍可用。
• 只有在所选日历路径报告支持原生功能时，才会请求提供方的会议链接。
• 交叉编译和合成测试夹具无法证明原生浏览器、密钥环、IPC、提供方、包管理器、Gatekeeper 或 SmartScreen 的行为。
• Teams 通话、录制和会议生命周期管理；租户范围的访问；无人值守登录；TLS 拦截；任意提供方操作；自动遥测；以及原始崩溃报告上传均不在范围内。

确切的操作矩阵和提供方类型化降级说明见 features.md。

一个本地安全边界

AI agents ───────── MCP over stdio ─┐
                                    ├── typed use cases + effect policy
Humans and scripts ──────── corr ───┘              │
                                                   │ authenticated local IPC
                                            session owner
                                            ├── browser-owned sessions
                                            ├── explicit OAuth + keyring
                                            └── standards adapters

会话所有者不会开放 TCP 监听器。在 Unix 上，客户端必须先验证并固定与环境无关的私有运行时目录、单实例锁、套接字和对端 UID，之后才能发送本地承载令牌。在 Windows 上，客户端必须先验证受保护的命名管道、所有者、DACL、服务器进程和 SID。

请阅读架构、 身份验证模型和 威胁模型，了解完整的安全边界。

文档

我想……	从这里开始
安装并验证一个发行版	安装
添加账户并选择路由	配置
了解浏览器、OAuth 和标准登录方式	身份验证
学习 CLI 命令	CLI 指南
连接 AI 客户端	MCP 指南
比较提供方操作和降级情况	功能矩阵
使用稳定的机器可读输出	JSON 契约
集成有版本管理的公共/本地契约	版本管理政策
验证兼容性声明	证据矩阵
查看隐私和 Google 数据处理方式	隐私政策
查看使用条款和开源许可证条款	使用条款
使用自己的桌面客户端连接 Google	Google OAuth 设置
查看暂未启用的托管客户端计划	Google 验证操作手册
查看所有指南	文档索引

从 v0.7 之前版本升级的用户可参阅历史迁移指南。corr 是主要命令。产品、软件包、代码库、配置根目录、插件和 MCP 服务仍名为 Corresync。

贡献与安全

请阅读 CONTRIBUTING.md 和 AGENTS.md。默认测试和 CI 仅使用合成测试数据：

mise exec -- task verify

请通过 GitHub 私密漏洞报告报告漏洞，切勿在公开议题中报告。

有关远程终端，请参阅 通过 SSH 进行图形化登录。