ruru-gcal-mcp

Google Calendar と Google Tasks を操作する MCP サーバー。

ツール

Calendar Events

| ツール | 説明 | |--------|------| | list_events | 年/月/日指定でイベント一覧を取得 | | search_events | キーワードでイベントを全文検索 | | create_event | イベントを作成（終日/時間指定/複数日/繰り返し対応） | | update_event | イベントを更新 | | delete_event | イベントを削除（本サーバーで作成したもののみ） |

Google Tasks

| ツール | 説明 | |--------|------| | list_tasks | タスク一覧を取得 | | create_task | タスクを作成（サブタスク対応） | | update_task | タスクを更新 | | complete_task | タスクを完了にする | | delete_task | タスクを削除 |

セットアップ

1. Google Cloud プロジェクトの準備

1. Google Cloud Console でプロジェクトを作成
2. APIs & Services > Library で以下を有効化:
   • Google Calendar API
   • Google Tasks API

2. OAuth 同意画面の設定

1. APIs & Services > OAuth consent screen を開く
2. User Type: External を選択（Google Workspace なら Internal を推奨）
3. アプリ情報を入力し、スコープに以下を追加:
   • https://www.googleapis.com/auth/calendar.events
   • https://www.googleapis.com/auth/tasks
4. テストユーザーに自分の Google アカウントを追加する

[!NOTE] 上記は Sensitive スコープのため、External + 本番公開には Google の検証が必要です。 Testing モードでは検証不要ですが、リフレッシュトークンが 7 日で失効します。 失効時はサーバーが自動でブラウザを開いて再認証するため、手動でのトークン再取得は不要です。

Google Workspace の Internal アプリなら検証不要かつ失効なしです。

3. OAuth クライアント ID の作成

1. APIs & Services > Credentials を開く
2. Create Credentials > OAuth client ID を選択
3. Application type: Desktop app
4. 認証情報の JSON ファイルをダウンロードする

4. 初回認証

サーバー初回起動時にブラウザが自動で開き、Google アカウントでの認証を求められます。 認証後、トークンは ~/.config/ruru-gcal-mcp/tokens.json に保存されます。

リフレッシュトークンが失効した場合（Testing モードでは 7 日後）も、 自動でブラウザが開いて再認証が行われます。

環境変数

| 変数名 | 必須 | 説明 | |--------|------|------| | GOOGLE_CREDENTIALS_PATH | 必須 | OAuth 認証情報 JSON ファイルのパス | | GOOGLE_CALENDAR_TIMEZONE | | タイムゾーン（デフォルト: Asia/Tokyo） |

使い方

Claude Desktop / Claude Code（stdio）

{
  "mcpServers": {
    "google-calendar": {
      "command": "npx",
      "args": ["ruru-gcal-mcp"],
      "env": {
        "GOOGLE_CREDENTIALS_PATH": "/path/to/credentials.json"
      }
    }
  }
}

HTTP モード

GOOGLE_CREDENTIALS_PATH=/path/to/credentials.json npx ruru-gcal-mcp --http

開発

npm install
npm run dev          # 開発サーバー起動
npm test             # テスト実行
npm run typecheck    # 型チェック
npm run check        # lint
npm run build        # ビルド

License

MIT