Google Photos

Google Workspace

Browse, search, and organize your photo library and albums

What You Can Do

Google Photos stores your memories — OpenClaw lets you search, organize, and retrieve them through conversation without opening the app.

  • List media items — Browse your photo library with pagination
  • Search by date — Filter photos taken in a specific date range
  • Search by category — Filter by content categories: LANDSCAPES, PEOPLE, ANIMALS, FOOD, SELFIES, TRAVEL, etc.
  • Search by description — Text-based search on photo descriptions
  • Get photo details — Filename, creation time, camera metadata (EXIF: make, model, exposure), dimensions, URL
  • Create albums — New named albums
  • List albums — Browse all your albums
  • Get album contents — Retrieve all media items in a specific album
  • Add items to albums — Put photos into albums by media item ID
  • Share albums — Generate shareable links for albums

    • Try Asking

  • "Find all photos I took in Japan in October 2024"
  • "Show me photos of food from this month"
  • "Create an album called 'Europe Trip 2025' and add photos from July 2025"
  • "What are the last 20 photos in my library?"
  • "Find all selfies from the last 3 months"
  • "List all my shared albums"
  • "Get the URL for the photo I took at the beach in August"

    • Pro Tips

  • The Photos API does NOT support upload or delete of individual items — those must happen through the app or Google Drive
  • Content category filters are ML-generated, not user-applied tags — accuracy varies
  • Media item URLs are valid for 60 minutes and are not permanent links
  • Album sharing requires creating a share token — the agent handles this automatically
  • Date range filters use `startDate` and `endDate` in YYYY-MM-DD format
  • EXIF camera metadata is available on photos taken by camera (not screenshots or downloads)