はじめに
僕は最近仕事をする中で、こんな悩みを抱えていました。
- 毎日日報でSlackのデータをMCP(slack-explorer-mcpの設定方法はこちら)で取得しつつ振り返るようにしているが、ミーティングの情報が拾えないため振り返りが難しいんだよな..
- 週のはじめにあるプランニングで「ミーティングがすでにたくさん入ってしまっているが、今週持っているタスクは終わるのか」確認が難しい..
- プランニングの後に、カレンダーにタスク登録するのを忘れてしまった..
Googleカレンダーの情報を取得、登録できれば、もっとPDCAが回しやすくなるのでは？と思い、Claude CodeのMCP連携を試してみました。
同じ悩みを持つ方の参考になれば嬉しいです。
この記事で出てくるキーワード
MCP連携
├── MCP (Model Context Protocol)
│ └── Claude Codeと外部サービスをつなぐ仕組み
├── MCPサーバー
│ └── @cocal/google-calendar-mcp (今回使用)
├── 認証
│ ├── OAuth 2.0
│ ├── Google Cloud Console
│ └── credentials.json
└── 設定ファイル
├── .mcp.json (プロジェクト設定)
└── .claude/settings.json (有効化設定)
MCPを使ってやりたいこと
やりたいこと1
- Googleカレンダーの予定を取得したい
やりたいこと2
- Googleカレンダーに予定を登録したい
どのMCPサーバーを選ぶ？
GoogleカレンダーのMCPサーバーはいくつか選択肢があります。
npx @cocal/google-calendar-mcp
npx @takumi0706/google-calendar-mcp
npx @sudomcp/google-calendar-mcp
今回は@cocal/google-calendar-mcpを選びました。
理由
- OAuth 2.0認証で安全性に問題なし
- 設定がシンプル
- マルチカレンダー対応
会社のカレンダーを使う場合は、念のため会社のセキュリティポリシーを確認してください。(僕は試験的に個人アカウントでお試し中...)
Google Cloud Consoleでの認証設定
設定の流れ
1. Google Cloud Consoleでプロジェクト作成
2. Google Calendar APIを有効化
3. OAuth認証情報を作成
4. credentials.jsonをダウンロード
5. テストユーザーに自分を追加
ステップ1: プロジェクト作成とAPI有効化
- Google Cloud Consoleにアクセス
- 新しいプロジェクトを作成
- 「APIとサービス」→「ライブラリ」
- 「Google Calendar API」を検索して有効化
ステップ2: OAuth認証情報の作成
「APIとサービス」→「認証情報」
↓
「+ 認証情報を作成」→「OAuth クライアント ID」
↓
アプリケーションの種類: 「デスクトップ アプリ」
↓
「作成」→ JSONをダウンロード
↓
credentials.json にリネーム
ステップ3: OAuth同意画面の設定
初回はOAuth同意画面の設定が必要です。
「ブランディング」画面で
├── アプリ名: 任意 (例: MCP Google Calendar)
├── ユーザーサポートメール: 自分のメール
└── デベロッパーの連絡先情報: 自分のメール
↓
「次へ」を数回クリック → 完了
ステップ4: テストユーザーの追加
「対象」タブ
↓
「テストユーザー」セクション
↓
「+ ADD USERS」
↓
自分のGmailアドレスを追加
↓
保存 (反映まで2-3分待つ)
Claude Codeでの設定
ファイル構成
your-project/
├── .mcp.json # MCPサーバー設定
├── .claude/
│ └── settings.json # MCP有効化設定
└── credentials.json # Google認証情報
.mcp.jsonの設定
プロジェクトルートに作成します。
{
"mcpServers": {
"google_calendar": {
"command": "/opt/homebrew/bin/npx",
"args": ["-y", "@cocal/google-calendar-mcp"],
"env": {
"GOOGLE_OAUTH_CREDENTIALS": "./credentials.json"
}
}
}
}
ポイント
-
command: npxのフルパス (which npxで確認) -
GOOGLE_OAUTH_CREDENTIALS: credentials.jsonへの相対パス
.claude/settings.jsonの設定
プロジェクトMCPを有効化します。
{
"enableAllProjectMcpServers": true,
"enabledMcpjsonServers": [
"google_calendar"
]
}
Claude Codeを起動
# プロジェクトディレクトリで
claude
# MCPサーバーの状態を確認
/mcp
初回認証
認証の流れ
Claude Codeで質問
↓
「今日の予定を教えて」
↓
ブラウザが自動的に開く
↓
Googleアカウントを選択
↓
「このアプリは確認されていません」
↓
「詳細」→「移動」をクリック
↓
カレンダーへのアクセスを許可
↓
認証完了
トラブルシューティング
403エラーが出た場合
エラー: access_denied
原因: テストユーザーに追加されていない
解決方法
- Google Cloud Console → OAuth同意画面 → 対象
- テストユーザーに自分のメールアドレスを追加
- 2-3分待ってから再試行
アカウントを切り替えたい場合
# トークンを削除
rm ~/.config/google-calendar-mcp/tokens.json
# 再認証
export GOOGLE_OAUTH_CREDENTIALS="./credentials.json"
npx @cocal/google-calendar-mcp auth
ブラウザが開くので、切り替えたいアカウントを選択すればOKです。
MCPサーバーがfailedになる場合
よくある原因
- npxのパスが間違っている →
which npxで確認 - credentials.jsonが見つからない → パスを絶対パスに変更
- Node.jsがインストールされていない →
brew install node
実際に使ってみる
やりたいこと1と2を実際に試してみます。
やりたいこと1: 予定を取得する
今週のMTGの合計時間を計算して
→ 今週のMTG合計: 9時間45分です
Googleカレンダーから予定を取得して、会議時間を集計してくれました。
やりたいこと2: 予定を登録する
毎日30分開発タスクについて考える時間を設けて
空いている時間を見つけて、自動的にカレンダーに登録してくれました。
これだけで、Googleカレンダーの取得・登録が行えます！