Corresync

Corresync

メール、カレンダー、タスク。1つのローカル MCP サーバーと CLI。
プロバイダーを問わず、ローカル優先のツールを AI エージェント、スクリプト、そしてあなたに。

ウェブサイト · はじめに · プロバイダー · 機能 · 安全性 · プライバシー · 利用規約 · 技術ドキュメント

corr を使うと、分離されたメール、カレンダー、タスクのアカウントを1つのターミナルと、1つのローカル Model Context Protocol サーバーにまとめられます。 Gmail、Google Calendar、Google Tasks は、自分で管理する Google Cloud プロジェクト内のデスクトップ OAuth クライアントを通じて利用できます。Corresync が管理する Google OAuth は引き続き無効です。 標準のタスクツールには、Microsoft To Do、Todoist、TickTick、CalDAV VTODO への明示的なルートも含まれています。その他のタスクプロバイダー用アダプターは、仕様が実装されるまで利用できません。

• アカウントやプロバイダーの由来を損なわずにメールを検索し、複数アカウントを横断する予定表を作成できます。
• プロバイダー用アダプターが利用可能になるにつれて、安定した由来情報を保持する単一のタスクモデルを使用できます。
• アカウントごとに非公開のメール検索や相対的なカレンダー期間を保存し、メールボックスやカレンダーの影のキャッシュを作成せずに、最新の状態で実行できます。
• 人が使いやすい CLI、安定した JSON、AI エージェントから、同じ型付き操作を利用できます。
• サインインは、表示されたブラウザー、明示的なパブリッククライアント 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

同じローカルコアにエージェントを接続します。

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.

プロバイダーの1つで障害が発生した場合は、部分的な失敗として明示されます。成功した結果は引き続き利用でき、書き込みには正確なアカウントの指定が必要です。

適切なルートを選択する

メール、カレンダー、タスクのルートはそれぞれ個別に選択します。たとえば、 1つのアカウントでIMAP/SMTPメールとCalDAVカレンダーを組み合わせられます。タスクのルートは 別途明示的に選択します。

ルート	メール	カレンダー	タスク	認証
Outlook Web	型指定された読み取りと書き込み	選択可能なカレンダー；プロバイダーがサポートするTeamsリンク	—	専用の可視ブラウザープロファイル
Google（お客様のOAuthクライアント）	Gmail APIによる読み取りと書き込み；完全削除は不可	選択可能なカレンダー；Google Meetが通知されている場合に利用	別個のタスク専用許可によるGoogle Tasks	お客様のDesktop OAuthクライアント；クライアント認証情報と許可情報はOSのキーチェーンに保存
Microsoft Graph	型指定された読み取りと書き込み	選択可能なカレンダー；型指定されたTeamsリンクの作成	Microsoft To Do	お客様が認可したパブリックOAuthクライアント；OSのキーチェーンに保存された許可情報
Todoist	—	—	型指定されたTodoist操作	お客様が認可したパブリックOAuthクライアント；OSのキーチェーンに保存された許可情報
TickTick	—	—	型指定されたTickTick操作	お客様が認可したコンフィデンシャルOAuthクライアント；外部シークレットハンドルとOSのキーチェーンに保存された許可情報
JMAP	型指定されたメール操作	—	—	OSのキーチェーンまたは承認済みの認証情報ヘルパー
IMAP / SMTP	IMAPによる読み取り／管理とSMTPによる下書き／送信	—	—	OSのキーチェーンまたは承認済みの認証情報ヘルパー
CalDAV	—	型指定されたカレンダー操作と条件付きスケジュール設定	VTODOリスト、検索、同期、確認済みの書き込み	OSのキーチェーンまたは承認済みの認証情報ヘルパー

検出では、認証情報を使わずにDNS、well-known、プロバイダーのメタデータを収集します。 認証やアカウントの追加は行いません。Microsoft Graphとユーザー所有の Google認証は明示的な選択肢であり、自動的な フォールバックとして使われることはありません。Googleの検出では、ガイド付きのDesktopクライアント設定を提示できますが、Googleへのサインインは、後から明示的にcorr auth loginを実行するまで開始されません。 Google設定ガイド（注釈付き）を参照してください。

iCloudには、プロバイダーに依存しない同一のIMAP/SMTPおよびCalDAVアダプターを利用した、ガイド付きの標準設定が用意されています。corr setupは、文書化されたiCloud Mailの アドレス形式または検証済みのApple SRVエンドポイント一式を認識し、 両方のルートを1つのアカウントとして確認し、デフォルトで1つの外部認証情報ハンドルを使用します。 アカウントの追加後、明示的な引き継ぎ操作でAppleのアプリ用パスワード ページとOSが管理する認証情報プロンプトを開けます。corrプロセスが アプリ固有のパスワードを読み取ることはありません。

上記の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 をインストールすることもできます。 このバンドルは、検証済みの corr mcp serve バイナリをローカルで stdio 経由で実行します。Corresync をデプロイしたり、メールボックスのデータを中継したりすることはありません。まず CLI をインストールして、以下の明示的なアカウント設定とサインインの手順を行い、その後 .mcpb を Claude Desktop で開くか、ドラッグしてください。

最新の状態に保つ

対話型コマンドは、起動時にキャッシュを利用して目立たない形でリリースを確認します。アップデートがある場合、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

ガイド付きセットアップでは、現在のローカル状態に基づいて再開可能な事前確認を行い、表示されたユーザーローカルのパスにシェル補完を任意でインストールした後、認証情報を使わずにアカウントを検出します。選択したメール、カレンダー、タスクの経路をプレビューし、確認後にのみアカウントを追加します。認証や外部認証情報へのアクセスは、別途選択する必要があります。同じ実行で、さらにアカウントを追加したり、検出された複数のエージェントホストを選択したり、それぞれ独立したローカル統合プランをプレビューしたり、確認済みのプランを1つだけ適用したり、各結果を検証したりできます。corr setup を再実行すると、問題のない処理はスキップされ、不足している手順や修復可能な手順が提示されます。

接続経路を選択すると、ウィザードにサービスのチェックリストが表示されます。Microsoft アカウントでは、Outlook Mail と Calendar があらかじめ選択されており、それぞれ個別に変更できます。Microsoft To Do は、明示的に Graph を認可する場合に利用できる任意のサービスです。Teams のメッセージ機能は、Teams Web 経由のプレビューとして、または Graph を明示的に認可して選択できます。Mattermost もプレビューとして利用できますが、これらの経路には、実運用環境での互換性を裏付ける証拠がまだ十分にありません。検出によって確認できるのは経路に関する情報のみです。チェックしたサービスがアカウントで有効になっていることを証明するものではなく、Graph へのフォールバックが実行されることもありません。 同じアカウントウィザードを開くには corr settings を実行します。矢印キーで操作するフォームから、アカウントへのサインイン、名前の変更、選択、削除を行い、更新、安全性、ブラウザーでのサインインを管理できます。セットアップガイドの項目からは、別の実装を保守することなく、完全なコーディネーターを再開できます。トップレベルの Accounts カテゴリーには、Add account と設定済みアカウントの一覧が含まれます。アカウントを選択すると、そのアカウントの操作だけが表示されます。削除時には、削除されるローカルデータを事前に表示して確認を求めます。デフォルトのアカウントを削除する場合は、先に置き換えるアカウントを選択します。それぞれの選択肢には対応するコマンドも表示されるため、対話形式のフローで直接 CLI の使い方も学べます。 行指向のスクリーンリーダー向けプロンプトを使うには、CORRESYNC_ACCESSIBLE=true を設定します。入力ステップを安全に終了するには、:cancel と入力します。直接 rename する形式は次のとおりです。

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 プロジェクトで Desktop OAuth クライアントを作成してください。ガイド付きセットアップでは、ダウンロードしたクライアント JSON を検証し、生成された認証情報を OS キーリングに保存します。アカウントの追加だけでは認証は行われません。最新の Cloud Console 画面、対象ユーザーの選択肢、正確な API とスコープ、インポート、ログインの手順については、Google OAuth セットアップガイドをご覧ください。

インストール前に、任意で利用できるプロバイダー互換性チェッカーを使うと、公開情報をもとにアドレスを分類できます。ブラウザーがリクエスト本文で送信するのは、@ より後のドメインのみです。ローカル部分は送信されず、アドレスも保存されず、サインインも開始されません。公開サービスが使用するのは固定の DNS リゾルバーのみで、生の DNS レコードは返しません。必要がなければ使わず、ローカルで corr account discover ADDRESS を実行してください。

アカウントの追加だけでは認証は行われません。OAuth ルートには、使用する権限のあるクライアント登録が必要です。Google ではさらに、生成された Desktop クライアント認証情報用の外部ハンドルが別途必要です。標準規格に準拠したルートでは、キーリングエントリーまたは明示的に承認されたヘルパー参照を使用します。パスワードやトークンが config.toml に保存されることはありません。アカウントとプロバイダーの設定をご覧ください。Outlook Web ルートでは、後から auth login を実行したときに、専用の可視プロファイルが開きます。このウィンドウは、アカウントからログアウトするかデーモンが終了するまで、ブラウザーが管理するセッションとして維持されます。SSO、MFA、Conditional Access、組織からのお知らせは、引き続きプロバイダーが管理するフロー内で表示されます。

3. エージェントを接続する

corr mcp setup codex

Claude Code、GitHub Copilot CLI、Gemini CLI、Qwen Code、Qoder、Kimi Code CLI、汎用の stdio クライアントについては、corr mcp --help をご利用ください。Corresync は、用途を絞った 45 個のツールと、読み取り専用のモニターリソース 2 個を公開します。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 からローカル通知、永続キュー、そして最後に承認済みのシェルを使用しないランナーへと、意図的に段階を踏んで移行できます。リモートへの送信には別途同意が必要です。
• **プライバシーを保護するフィードバック：**許可リストに基づくレポートをローカルで生成して確認した後、明示的にコピー、保存、または内容を事前入力した GitHub ページを開きます。別のデフォルトで無効の設定を有効にすると、対話型の失敗後に、さらに限定された許可リストのみの公開イシューを、認証済みの gh クライアントから送信できます。

メールボックス、カレンダー、インポート、イベントキューの値は、プライベートな外部データであり、信頼できないものです。その内容がコマンドの実行やエージェントの起動を許可することはありません。

適用範囲の明示

• Gmail、Google Calendar、Google Tasks には、ユーザー所有の Google Desktop OAuth クライアントが必要です。Corresync が管理する Google OAuth は無効のままです。ユーザー所有の方式は合成コントラクトテストで検証されていますが、実環境では未観測です。
• Microsoft Graph には、ユーザー独自の認可済みパブリッククライアント登録が必要です。Corresync はトークンリレーを同梱していません。
• Corresync は AppUserModelID をインストールしないため、Windows デスクトップ通知の設定は利用できません。キューおよび承認済みランナーのモードは引き続き利用できます。
• プロバイダーの会議リンクは、選択されたカレンダールートがネイティブ対応を報告した場合にのみ要求されます。
• クロスコンパイルと合成フィクスチャでは、ネイティブのブラウザー、キーチェーン、IPC、プロバイダー、パッケージマネージャー、Gatekeeper、SmartScreen の動作は証明されません。
• Teams の通話、録音、会議ライフサイクル管理、テナント全体へのアクセス、無人ログイン、TLS インターセプト、任意のプロバイダー操作、自動テレメトリ、クラッシュデータの生アップロードは対象外です。

正確なアクションマトリックスと、型付きのプロバイダー機能縮退については features.mdをご覧ください。

1つのローカル安全境界

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 の非公開脆弱性報告から報告してください。公開の Issue では報告しないでください。

リモート端末については、SSH 経由のグラフィカルログインを参照してください。