From superpowers
Automates Google Photos tasks (upload media, manage albums, search photos, batch add items) via Rube MCP (Composio). Always searches tools first for current schemas.
How this skill is triggered — by the user, by Claude, or both
Slash command
/superpowers:googlephotos-automationThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Upload photos, manage albums, search media items, and batch-organize content in Google Photos using Rube MCP (Composio).
Upload photos, manage albums, search media items, and batch-organize content in Google Photos using Rube MCP (Composio).
Toolkit docs: composio.dev/toolkits/googlephotos
RUBE_MANAGE_CONNECTIONS with toolkit googlephotosRUBE_SEARCH_TOOLS first to get current tool schemasGet Rube MCP: Add https://rube.app/mcp as an MCP server in your client configuration. No API keys needed — just add the endpoint and it works.
RUBE_SEARCH_TOOLS respondsRUBE_MANAGE_CONNECTIONS with toolkit googlephotosUse GOOGLEPHOTOS_LIST_ALBUMS to retrieve all albums visible in the user's Albums tab.
Tool: GOOGLEPHOTOS_LIST_ALBUMS
Parameters:
- pageSize: Number of albums per page
- pageToken: Pagination token
- excludeNonAppCreatedData: Only show albums created by this app
Use GOOGLEPHOTOS_CREATE_ALBUM to create a new album in Google Photos.
Tool: GOOGLEPHOTOS_CREATE_ALBUM
Parameters:
- title (required): Album title
Use GOOGLEPHOTOS_UPLOAD_MEDIA to upload an image or video file to Google Photos.
Tool: GOOGLEPHOTOS_UPLOAD_MEDIA
Parameters:
- file_to_upload: Local file path to upload
- url: URL of file to upload (alternative to file_to_upload)
- file_name: Name for the uploaded file
- description: Description/caption for the media item
Use GOOGLEPHOTOS_BATCH_CREATE_MEDIA_ITEMS to upload multiple files and create media items in one operation.
Tool: GOOGLEPHOTOS_BATCH_CREATE_MEDIA_ITEMS
Parameters:
- files: Local file paths to upload
- urls: URLs of files to upload
- media_files: Mixed input (files and URLs)
- albumId: Album to add items to
- albumPosition: Position within the album
Use GOOGLEPHOTOS_SEARCH_MEDIA_ITEMS to search the user's photo library with filters.
Tool: GOOGLEPHOTOS_SEARCH_MEDIA_ITEMS
Parameters:
- albumId: Filter by album
- filters: Search filters (date ranges, content categories, media types)
- orderBy: Sort order
- pageSize: Results per page
- pageToken: Pagination token
Use GOOGLEPHOTOS_BATCH_ADD_MEDIA_ITEMS to add existing media items to an album.
Tool: GOOGLEPHOTOS_BATCH_ADD_MEDIA_ITEMS
Parameters:
- albumId (required): Target album ID
- mediaItemIds (required): Array of media item IDs to add
GOOGLEPHOTOS_CREATE_ALBUM to create an album, then GOOGLEPHOTOS_BATCH_CREATE_MEDIA_ITEMS with the album ID to upload and organize photos in one step.GOOGLEPHOTOS_SEARCH_MEDIA_ITEMS or GOOGLEPHOTOS_LIST_MEDIA_ITEMS to find media item IDs, then GOOGLEPHOTOS_BATCH_ADD_MEDIA_ITEMS to add them to albums.GOOGLEPHOTOS_UPDATE_ALBUM to change an album's title or cover photo.GOOGLEPHOTOS_GET_ALBUM with an album ID to retrieve full album information.GOOGLEPHOTOS_ADD_ENRICHMENT to add text overlays, locations, or map enrichments to album positions.url parameter in GOOGLEPHOTOS_UPLOAD_MEDIA or urls in GOOGLEPHOTOS_BATCH_CREATE_MEDIA_ITEMS to upload images directly from web URLs.GOOGLEPHOTOS_LIST_MEDIA_ITEMS is deprecated -- prefer GOOGLEPHOTOS_SEARCH_MEDIA_ITEMS for listing and filtering media.GOOGLEPHOTOS_UPLOAD_MEDIA supports images up to 200MB and videos up to a larger limit. Exceeding these will fail.GOOGLEPHOTOS_LIST_ALBUMS or GOOGLEPHOTOS_CREATE_ALBUM responses -- they are opaque strings.GOOGLEPHOTOS_BATCH_ADD_MEDIA_ITEMS can only add items to albums created by the app or albums the user owns.filters parameter in GOOGLEPHOTOS_SEARCH_MEDIA_ITEMS uses a specific Google Photos API filter structure -- consult the schema for date range and content category formats.| Action | Tool | Key Parameters |
|---|---|---|
| List albums | GOOGLEPHOTOS_LIST_ALBUMS | pageSize, pageToken |
| Create album | GOOGLEPHOTOS_CREATE_ALBUM | title |
| Get album | GOOGLEPHOTOS_GET_ALBUM | albumId |
| Update album | GOOGLEPHOTOS_UPDATE_ALBUM | albumId, title, coverPhotoMediaItemId |
| Upload media | GOOGLEPHOTOS_UPLOAD_MEDIA | file_to_upload or url, description |
| Batch upload | GOOGLEPHOTOS_BATCH_CREATE_MEDIA_ITEMS | files or urls, albumId |
| Search media | GOOGLEPHOTOS_SEARCH_MEDIA_ITEMS | albumId, filters, pageSize |
| List media items | GOOGLEPHOTOS_LIST_MEDIA_ITEMS | pageSize, pageToken |
| Add items to album | GOOGLEPHOTOS_BATCH_ADD_MEDIA_ITEMS | albumId, mediaItemIds |
| Add enrichment | GOOGLEPHOTOS_ADD_ENRICHMENT | albumId, newEnrichmentItem, albumPosition |
Powered by Composio
npx claudepluginhub lunartech-x/superpowers --plugin superpowersCreates, curates, and publishes Immich albums organized by geography, theme, or custom criteria. Automates album creation from user prompts like 'create an album from my trip to Italy'.
Automates Smugmug photo management via Composio's toolkit through Rube MCP. Handles connection setup, tool discovery, and execution workflows.
Batch downloads original photos from PhotoPlus album links (photoplus.cn/live/). Extracts album ID, confirms with user, and runs a Python script with multi-threading and skip support.