clawlink-hq Google Photos
Use Google Photos from your AI agent through ClawLink — browser login, no API key to paste, no config to edit. Connect Google Photos once and the agent can read and act on it. Works in any agent that can run shell commands (Claude Code, Cursor, Codex, Cline, and more).
Setup
Run these once — the agent can run them for you:
npx @useclawlink/cli login # opens browser → approve (mints + stores a key)
npx @useclawlink/cli connect googlephotos # opens browser → authorize Google Photos
No API key to create or paste — login stores the credential at ~/.clawlink/credentials.json.
Using Google Photos
npx @useclawlink/cli actions googlephotos "<what you want to do>" # find an action
npx @useclawlink/cli describe googlephotos <action-id> # see its inputs (before writes)
npx @useclawlink/cli run googlephotos <action-id> --input '<json>' # execute
Reads first; confirm with the user before any write.
Available actions
| Action | Description |
|---|---|
googlephotos_add_enrichment |
Adds an enrichment at a specified position in a defined album. |
googlephotos_batch_add_media_items |
Adds one or more media items to an album in Google Photos. |
googlephotos_batch_create_media_items |
Batch upload and create media items in Google Photos. Supports three input methods: 1. 'urls': Simple list of public URLs (file names extracted automatically) 2. 'media_files': List of objects with url/file, file_name, and description 3. 'files': List of FileUploadable objects for pre-uploaded files Media items can optionally be added to an album at a specific position. Maximum 50 items per request. |
googlephotos_batch_get_media_items |
Returns the list of media items for the specified media item identifiers. |
googlephotos_create_album |
Creates a new album in Google Photos. |
googlephotos_get_album |
Returns the album based on the specified albumId. |
googlephotos_get_media_item_download |
Downloads a media item from Google Photos and returns it as a file. |
googlephotos_list_albums |
Lists all albums shown to a user in the Albums tab of Google Photos. |
googlephotos_list_media_items |
Lists media items created by this application from Google Photos. DEPRECATION NOTICE: As of March 31, 2025, the Google Photos Library API ONLY returns media items that were uploaded/created by your application. This action CANNOT access the user's full photo library. Use cases this action SUPPORTS: - Listing photos/videos your app previously uploaded to the user's library - Managing app-created content in Google Photos Use cases this action DOES NOT SUPPORT: - Accessing photos taken by the user's camera - Viewing photos from other apps or web uploads - Listing the user's entire photo library For accessing a user's full library, use the Google Photos Picker API instead: https://developers.google.com/photos/picker |
googlephotos_search_media_items |
Searches for media items in a user's Google Photos library. |
googlephotos_update_album |
Updates an album's title or cover photo in Google Photos. |
googlephotos_update_media_item |
Updates a media item's description in Google Photos. |
Notes
- No API key for Google Photos itself — ClawLink holds the OAuth token; the agent only holds your ClawLink credential.
- Not connected yet, or access expired? Re-run
npx @useclawlink/cli connect googlephotos. - The action list above is a snapshot;
npx @useclawlink/cli actions googlephotosis always current.
Resources
- ClawLink: https://claw-link.dev
- Docs: https://docs.claw-link.dev
- CLI: https://www.npmjs.com/package/@useclawlink/cli
Powered by ClawLink — connect 90+ apps to any AI agent.