Назад към всички

google-photos

// Manage Google Photos library. Upload photos, create albums, and list library content. Use when the user wants to backup, organize, or share images via Google Photos.

$ git log --oneline --stat
stars:1,933
forks:367
updated:March 4, 2026
SKILL.mdreadonly
SKILL.md Frontmatter
namegoogle-photos
descriptionManage Google Photos library. Upload photos, create albums, and list library content. Use when the user wants to backup, organize, or share images via Google Photos.
metadata[object Object]

Google Photos

This skill provides a way to interact with Google Photos Library API to automate photo management.

Setup

  1. Enable API: Enable the "Google Photos Library API" in your Google Cloud Console project.
  2. Credentials: Download your OAuth 2.0 Client ID credentials as credentials.json.
  3. Environment: This skill uses a Python virtual environment located in its folder.

Usage

All commands are run through the scripts/gphotos.py script.

List Albums

Useful for finding the ID of an existing album.

./scripts/gphotos.py --action list --credentials /path/to/credentials.json --token /path/to/token.pickle

Create a New Album

./scripts/gphotos.py --action create --title "Vacations 2026" --credentials /path/to/credentials.json --token /path/to/token.pickle

Upload a Photo

You can optionally specify an --album-id to add the photo to a specific album.

./scripts/gphotos.py --action upload --photo "/path/to/image.jpg" --album-id "ALBUM_ID" --credentials /path/to/credentials.json --token /path/to/token.pickle

Privacy & Security

  • This skill only has access to photos it uploads or that are explicitly shared with the application.
  • Credentials and tokens are stored locally and should be kept secure.
  • Never share your credentials.json or token.pickle files.