コンテンツにスキップ

連携2026/11/16約1分で読めます

Google カレンダー

Mitra は、他のカレンダーサーバーと同様に CalDAV 経由で Google カレンダーに接続します。異なるのはサインインです。Google はパスワードを受け付けず、独自のページでアクセスを許可させます。そのために Google があなたの Mitra サーバーを知っている必要があるので、サーバーを運営する人が一度だけ Google に登録し、発行されたクライアント ID とシークレットを Mitra に渡します。

その後は、Mitra を使う人それぞれがアプリから自分の Google アカウントを、個別の許可で接続します。セットアップは3つの手順です。

  1. Mitra を Google に登録する。
  2. Mitra にクライアント ID とシークレットを渡す。
  3. アカウントを接続する。

最初の2つは Mitra サーバーごとに一度だけ行います。

  1. Google Cloud コンソールでプロジェクトを作成し、API とサービスで CalDAV API を有効にします。

  2. OAuth 同意画面を設定します。アカウントを接続する自分と全員をテストユーザーとして追加するか、アプリを公開します。

  3. タイプウェブアプリケーションの OAuth クライアントを作成します。承認済みのリダイレクト URI には、あなたの Mitra サーバーのアドレスに /api/integrations/google/callback を続けたものを入力します。

    https://mitra.example.com/api/integrations/google/callback
  4. Google が表示するクライアント ID とクライアント シークレットをコピーします。

CAUTION

同意画面がテスト中の間、Google は各許可を7日で終了させるため、全員が毎週アカウントを接続し直す必要があります。アプリを公開すれば、許可はずっと有効です。

Mitra にクライアント ID とシークレットを渡す

Section titled “Mitra にクライアント ID とシークレットを渡す”

これらを環境変数として、サーバーのアドレスである MITRA_URL と一緒に設定します。

services:
mitra:
image: ghcr.io/a11delavar/mitra:latest
environment:
MITRA_URL: 'https://mitra.example.com'
MITRA_GOOGLE_CLIENT_ID: '….apps.googleusercontent.com'
MITRA_GOOGLE_CLIENT_SECRET: '…'
# …

その後 Mitra を再起動します。

Terminal window
docker compose up -d

変数は両方設定するか、両方設定しないかのどちらかです。クライアント ID だけでシークレットがない状態では Mitra は起動を拒否するので、中途半端な設定が見逃されることはありません。

MITRA_URL はリダイレクト URI のアドレスと一致している必要があります。これがなければ、Mitra は開かれたアドレスを使います。localhost で試す分にはそれで十分です。localhost 以外では Google が https:// のリダイレクトアドレスしか受け付けないため、実運用のサーバーには HTTPS と MITRA_URL が必要です。すべての変数は設定に一覧されています。

  1. サイドバー下部の連携を追加を選び、Google カレンダーを選びます。
  2. Google で続行を押します。Google がアカウントの選択と、Mitra へのカレンダーの閲覧・変更の許可を求めます。
  3. Mitra に戻ると、アカウントのカレンダーがすべてオンの状態で一覧されます。不要なものをオフにして保存を押します。

同じ Google アカウントを再度接続しても二重には追加されず、許可が更新されます。

Google はアプリが呼び出せる頻度を制限しているため、Mitra は Google アカウントを約1分ごとに同期します(同期の仕組みを参照)。

自分のカレンダーは接続と同時に現れます。チームや同僚のカレンダーなど、他の人が共有したカレンダーは、Google の設定で許可して初めて他のアプリに届きます。

  1. Google にサインインした状態で calendar.google.com/calendar/syncselect を開きます。
  2. 共有カレンダーで Mitra に取り込みたいカレンダーにチェックを付け、保存を押します。
  3. Mitra でサイドバーのアカウントの ⋯ メニューを開き、編集を選んで更新を押します。
  4. 現れたカレンダーをオンにして保存を押します。

すべての予定の詳細を表示で共有されたカレンダーは、Mitra では読み取り専用です。中身はすべて見えますが、予定の追加・変更・削除はできません。あとでオーナーが予定を変更の権限を与えれば、次の同期で編集できるようになります。読み取り専用カレンダーを参照してください。

項目間の関連付けを除き、CalDAVと同じように同期されます。Google は予定のコピーから関連付けを取り除くため、Mitra は Google カレンダーでは関連付けを提供しません。

Google カレンダーの添付ファイルは、Google カレンダーで添付する Google ドライブのファイルです。Mitra はそれらを表示し、それぞれドライブで開けますが、追加も削除もできません。Google はドライブのファイルのみを保持し、他のアプリが追加した添付は破棄します。

Google カレンダーで予定ありにした対応可能時間は、そのカレンダーに予定ありの予定として追加され、他の人にもその時間が埋まっているように見えます。動作は CalDAV と同じです。

Google が発行するトークンがサーバーの外に出ることはありません。ブラウザーが通るのはアクセスを許可する Google のページだけです。Mitra はトークンをアカウントと一緒に保持し、同期のたびに短期間のアクセスを得るために使います。

アカウントとそのトークンを Mitra から取り除くには、アカウントの ⋯ メニューで削除を選びます。Google 側でも Mitra のアクセスを取り消すには、Google アカウントのサードパーティ接続から Mitra を削除します。それだけを行っても同期は止まります。アカウントは Mitra に残りますが、再接続するまで同期はすべて失敗します。

  • Google カレンダーを選んだときに Google で続行ボタンではなく「このサーバーでは設定されていません」という表示が出る場合は、MITRA_GOOGLE_CLIENT_ID と MITRA_GOOGLE_CLIENT_SECRET が設定されていないか、設定後に Mitra が再起動されていません。
  • Google が redirect_uri_mismatch を返す場合は、Google Cloud コンソールのリダイレクト URI が MITRA_URL に /api/integrations/google/callback を続けたものと一致していません。https:// を含め、末尾のスラッシュも付けずに完全一致させる必要があります。
  • 7日後にアカウントの同期が止まる場合は、同意画面がまだテスト中です。アプリを公開してから、アカウントを接続し直してください。