MCP Meet

🚀 mcp - meet

このツールは、Google Meetを使ったカレンダー予定の設定を簡単にするためのものです。Googleアプリをローカルで実行するのが嫌で、Appleのネイティブアプリを使いたい人に最適です。Claudeに予定を設定するように依頼するだけで、Appleカレンダーに予定が設定され、Google Meetのリンクが自動生成されます。

✨ 主な機能

• 連絡先検索 - Google連絡先から名前またはメールアドレスで人を検索できます。
• スマートな空き時間確認 - 複数のカレンダーと参加者の空き/予定済み状況をチェックできます。
• 共通の空き時間 - 全員が実際に空いている時間を見つけることができます。
• ワンクリック予定設定 - 自動的に最適な時間帯を見つけて予約します。
• Google Meetリンク - すべてのミーティングには、すぐに使えるMeetリンクが付属しています。
• Appleカレンダー同期 - ミーティングが自動的にmacOSのカレンダーアプリに表示されます。
• 完全なCRUD操作 - GoogleとAppleのカレンダーを同期しながら、ミーティングを一覧表示、表示、更新、削除できます。

📚 詳細ドキュメント

アカウントツール

1. list_accounts - 設定されたすべてのGoogleアカウントとそのラベルを一覧表示します。

予定設定ツール

2. search_invitees - Google連絡先を検索してメールアドレスを見つけます。
3. find_slots - すべての参加者の共通の空き時間帯のリストを取得します。
4. create_meet_and_calendar - GoogleカレンダーのイベントをMeetリンク付きで作成し、Appleカレンダーにも反映します。
5. plan_and_schedule - 賢いツールです。指定した時間枠内で最初に空いている時間帯を見つけ、すぐに予約します。

ミーティング管理ツール

6. list_meetings - 特定の時間枠内のすべての今後のGoogle Meetミーティングを一覧表示します。
7. get_meeting_details - IDを指定して特定のミーティングの詳細情報を取得します。
8. update_meeting - ミーティングのタイトル、時間、説明、または参加者を更新します（Appleカレンダーにも同期されます）。
9. delete_meeting - GoogleとAppleのカレンダーからミーティングを削除します。

📦 インストール

前提条件

• Node.js 18以降
• CalendarとPeople APIが有効になっているGoogle Cloudプロジェクト
• OAuth 2.0の認証情報（クライアントIDとシークレット）
• macOS（Appleカレンダー統合のため）

インストール手順

npm install mcp - meet

または、ソースからクローンしてビルドすることもできます：

git clone https://github.com/znz - systems/mcp-meet.git
cd mcp-meet
pnpm install
pnpm build

設定

Google OAuthの認証情報を含む.envファイルを作成します：

GOOGLE_CLIENT_ID=your-client-id.apps.googleusercontent.com
GOOGLE_CLIENT_SECRET=your-client-secret
GOOGLE_REDIRECT_URI=http://localhost:5173

# オプション: 空き時間をチェックするカレンダーを指定する（カンマ区切り）
CALENDAR_IDS=primary,your-other-calendar@gmail.com

# オプション: イベントを作成するAppleカレンダーの名前（デフォルトは "Meetings"）
APPLE_CALENDAR_NAME=Work

Google OAuthの設定

1. Google Cloud Consoleにアクセスします。
2. 新しいプロジェクトを作成するか、既存のプロジェクトを選択します。
3. Google Calendar API と People API を有効にします。
4. OAuth 2.0の認証情報（デスクトップアプリタイプ）を作成します。
5. http://localhost:5173 を承認済みのリダイレクトURIとして追加します。
6. クライアントIDとクライアントシークレットを .env ファイルにコピーします。

初回の認証

アクセスを許可するための認証フローを実行します：

pnpm cli auth

これにより、Googleサインイン用のブラウザが開きます。完了すると、トークンは ~/.config/mcp-meet/tokens.json に保存され、使用可能になります。

💻 使用例

MCPサーバーとしての使用

stdioトランスポートを使用してサーバーを起動します（AIアシスタントとの統合用）：

node dist/index.js

開発環境では：

pnpm dev

MCPクライアント（Claude Desktopなど）は、利用可能なツールを呼び出すことができます。

Claude Desktop / Claude Codeの設定

MCP設定ファイル（claude_desktop_config.json または .mcp.json）に追加します：

{
  "mcpServers": {
    "mcp-meet": {
      "command": "npx",
      "args": ["-y", "mcp-meet"]
    }
  }
}

または、グローバルにインストールした場合は：

{
  "mcpServers": {
    "mcp-meet": {
      "command": "mcp-meet"
    }
  }
}

📄 ライセンス

MIT

🤝 コントリビューション

イシューとプルリクエストを歓迎します！