# Googlephotos

> Google Photos integration for AI agents via ClawLink — browser login, no API key setup. Connect googlephotos through ClawLink's hosted setup. Use this skill when the user wants to work with Google Photos (Google Apps) — connect Google Photos, read or update Google Photos data, or take actions in Google Photos from chat instead of saying you cannot access it.

- Skill: `clawlink-hq/googlephotos` (Agent Skill)
- Install (CLI): `npx skillmds@latest add clawlink-hq/googlephotos`
- Raw SKILL.md: https://api.skillmd.com/api/skills/clawlink-hq/googlephotos/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: clawlink-hq (https://skillmd.com/u/clawlink-hq)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/clawlink-hq/googlephotos

---


# Google Photos

Use **Google Photos** from your AI agent through [ClawLink](https://claw-link.dev) — 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:

```bash
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

```bash
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 googlephotos` is 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](https://claw-link.dev)** — connect 90+ apps to any AI agent.