@t.miyano/mcp-google-calendar

Google Calendarのアラーム（リマインダー）を管理するMCP (Model Context Protocol) サーバーです。AIエディタ（Cursor等）からGoogleカレンダーに接続し、スケジュールのアラームを操作できます。

機能

このMCPサーバーは、Google Calendar APIと連携して以下の機能を提供します：

• アラーム一覧の取得: 指定期間内のアラーム（リマインダー付きイベント）を取得
• アラームの作成: 新しいアラームをGoogleカレンダーに登録
• アラームの更新: 既存のアラーム情報を変更
• アラームの削除: アラームを削除

インストール

npm install -g @t.miyano/mcp-google-calendar

セットアップ

1. Google Calendar APIの認証情報を取得

1. Google Cloud Consoleでプロジェクトを作成
2. Google Calendar APIを有効化
3. OAuth 2.0認証情報を作成（デスクトップアプリケーション用）
4. 認証情報をJSON形式でダウンロード

2. 認証情報ファイルの配置

認証情報ファイルを以下の場所に配置してください：

# macOS/Linux
~/.config/mcp-google-calendar/credentials.json

# Windows
%APPDATA%\mcp-google-calendar\credentials.json

認証情報ファイルの形式：

{
  "installed": {
    "client_id": "YOUR_CLIENT_ID.apps.googleusercontent.com",
    "project_id": "your-project-id",
    "auth_uri": "https://accounts.google.com/o/oauth2/auth",
    "token_uri": "https://oauth2.googleapis.com/token",
    "auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs",
    "client_secret": "YOUR_CLIENT_SECRET",
    "redirect_uris": ["http://localhost"]
  }
}

3. 初回認証

MCPサーバーを初めて起動すると、ブラウザが自動的に開き、Googleアカウントでの認証を求められます。認証が完了すると、認証トークンが自動的に保存され、次回以降は自動的にログインされます。

Cursorでの設定

STDIOモード（推奨）

CursorのMCP設定ファイル（~/.cursor/mcp.json）に以下を追加してください：

{
  "mcpServers": {
    "google-calendar": {
      "command": "mcp-google-calendar",
      "args": ["--transport", "stdio"]
    }
  }
}

Node.jsバージョン管理ツール（mise等）を使用する場合

{
  "mcpServers": {
    "google-calendar": {
      "command": "mise",
      "args": [
        "exec",
        "--",
        "mcp-google-calendar",
        "--transport",
        "stdio"
      ]
    }
  }
}

設定後の確認

1. Cursorを再起動
2. Cursorの設定画面でMCPサーバーの接続状態を確認
3. エラーが表示される場合は、ログを確認してください

使用方法

設定が完了すると、CursorのAIアシスタントから以下のようにGoogleカレンダーのアラームを操作できます：

アラーム一覧の取得

「来週のアラームを教えて」などの指示で、指定期間内のアラーム一覧を取得できます。

アラームの作成

「明日の10時に会議のアラームを設定して」などの指示で、新しいアラームを作成できます。

アラームの更新・削除

既存のアラーム情報を変更したり、削除したりすることも可能です。

トラブルシューティング

認証エラーが発生する

• credentials.jsonファイルが正しい場所に配置されているか確認してください
• OAuth 2.0認証情報が正しく記入されているか確認してください
• リダイレクトURIがhttp://localhostに設定されているか確認してください

Cursorで接続できない

• mcp.jsonの設定が正しいか確認してください
• Cursorを完全に再起動してください
• コマンドmcp-google-calendar --transport stdioを直接実行してエラーを確認してください

認証情報をクリアしたい

mcp-google-calendar --clear-auth

ライセンス

MIT License

開発者向け情報

開発者向けの詳細情報は docs/README.dev.md を参照してください。