Skill

google-photos

Google Photos Library and Picker APIs for app-created media, albums, uploads, and user-selected media.

Verified: 2026-05-13 (printing-press-ingest-2026-05-13+enrich-capability-skill)

When to use google-photos

Choose if

Your agent needs to upload, search, or organize media inside Google Photos — either app-created content the agent owns end-to-end, or user-selected media via the Picker flow. Safety flags (safety_readonly, safety_agent_safe) let you constrain the agent to read-only operations, and the OAuth setup is one-time.

Avoid if

You need to read or mutate the user's pre-existing Google Photos library end-to-end — Library API scopes only cover app-created albums and media. For broader access, use the Picker flow per-session (which requires user consent each time). Not suited for headless / fully-autonomous reads of arbitrary user photos.

Risk Flags

  • MEDIUM scope Google Photos Library API read and edit scopes are limited to app-created albums and media — agents cannot read or mutate the user's pre-existing library through Library API commands. Picker session commands access the broader library but require explicit user consent per session.
  • MEDIUM auth OAuth tokens stored locally and must be managed securely. Safety flags (safety_readonly, safety_agent_safe) need to be set explicitly to block mutations, uploads, and deletes when the agent should only read.
  • MEDIUM rate_limit Exit code 7 indicates rate limiting is possible; README does not publish concrete quotas. Heavy upload or media-search workloads may trip Google's per-project caps.
  • LOW runtime Picker session deletion requires cleanup; undeleted sessions may consume resources. Agents should always close sessions after use.

Cost

Type: Free · Free tier: The CLI is MIT-licensed and free. Google Photos APIs are free for standard quotas; storage counts against the user's Google account.

Install

Default

npx -y @mvanhorn/printing-press install google-photos

Setup docs →

Estimated time to first success: ~15 min

Dependencies

Minimum runtime: Node.js (for npx) or Go 1.26.3+ (source fallback)

Distribution

Repository
https://github.com/mvanhorn/printing-press-library
License
MIT