Google Photosの統合のためのモデルコンテキストプロトコル(MCP)サーバー、Claude、Gemini、その他のAIアシスタントが、Googleフォトライブラリから**写真を読み、書き、および選択できるようにします。

✅ Picker API サポート(2025年3月)

このサーバーは、特定のライブラリ API スコープの 2025 減価償却後であっても、Google Photos Picker API を実行します。

| 機能 | ステータス | API | | お問い合わせ | | 完全フォトライブラリー | ✅ | ピッカー API | | テキスト・日付・カテゴリーから探す | ✅ | ライブラリ API | | アルバムの作成・アップロード | ✅ | ライブラリー API | | アクセスアプリ作成コンテンツ | ✅ | ライブラリー API |

##Picker APIの仕組み

1. [create_picker_session を呼び出して、ユーザがブラウザで開く認証セッション URL ([pickerUri) を返します。 2。 ユーザーは、インタラクティブに個人的なGoogleフォトライブラリ全体から写真やビデオを選択します。
2. [poll_picker_session を呼び出して、セッションの状態を確認します。 [mediaItemsSetが真の場合、選択した項目 ID、ファイル名、MIMEタイプ、寸法、ベースURLが返されます。
3. [[download_picker_media - OAuthベアトークンを使用して認証されたメディアバイトをダウンロード:

Google Photos MCP Server

A Model Context Protocol (MCP) server for Google Photos integration, enabling Claude, Gemini, and other AI assistants to read, write, and pick photos from your Google Photos library.

✅ Picker API Support (March 2025+)

This server implements the Google Photos Picker API, providing full library access even after the March 31, 2025 deprecation of certain Library API scopes.

How the Picker API works

1. Call create_picker_session — returns an authenticated session URL (pickerUri) that the user opens in their browser.
2. The user interactively selects photos and videos from their entire personal Google Photos library.
3. Call poll_picker_session — checks session status. When mediaItemsSet is true, the selected items’ IDs, filenames, MIME types, dimensions, and base URLs are returned.
4. Call download_picker_media — downloads authenticated media bytes using OAuth bearer tokens:
   • Image downloads: Downloads original full-resolution files (=d) by default. Supports custom bounding boxes via width and height parameters (=w{width}-h{height}, range: 1–16,383 pixels). When downloadOriginal: false is supplied without explicit dimensions, defaults to =w2048-h2048 preview.
   • Video downloads: Google Photos base URLs exclusively provide high-quality transcoded MP4 streams (=dv). Unmodified original video files are not exposed via base URLs per Google API design; responses include isTranscoded: true. Video bytes can only be requested once video processingStatus is explicitly READY.
   • Session & identity validation: When specifying baseUrl alongside sessionId, the server verifies the item exists in the session. If mediaItemId is also provided, both must identify the same selected item.
   • Storage & memory safety: Media bytes can be streamed directly to disk via savePath with O(1) heap overhead (strongly recommended for large files and videos). In-memory base64 responses (includeBase64: true) are capped at 10MB to avoid process heap exhaustion (raw binary payloads exceeding ~7.5MB, which expand to >10MB in base64, are rejected with guidance to use savePath). When includeBase64: false is specified, savePath is required.
   • Origin allowlist: Enforces HTTPS and strictly restricts base URLs to official Google Photos media domains (*.googleusercontent.com, *.photos.google.com, photoslibrary.googleapis.com) to prevent SSRF and token exfiltration.
5. Call delete_picker_session — cleans up the session after all desired media items and bytes have been retrieved.

🛡️ Security Notice: CORS Removed

CORS middleware has been removed for security (prevents drive-by attacks on localhost).