googlephotos-automation
Automate Google Photos tasks via Rube MCP (Composio): upload media, manage albums, search photos, batch add items, create and update albums. Always search tools first for current schemas.
- License 许可
- MIT
- 最近更新
- 2026-11-03
- Stars
- ★ 1
- Forks
- 0
01 前言 Front Matter
- name
- googlephotos-automation
- requires
- { "mcp": [ "rube" ] }
- description
- Automate Google Photos tasks via Rube MCP (Composio): upload media, manage albums, search photos, batch add items, create and update albums. Always search tools first for current schemas.
03 SKILL.md 正文
Google Photos Automation via Rube MCP
Upload photos, manage albums, search media items, and batch-organize content in Google Photos using Rube MCP (Composio).
Toolkit docs: composio.dev/toolkits/googlephotos
Prerequisites
- Rube MCP must be connected (RUBE_SEARCH_TOOLS available)
- Active connection via
RUBE_MANAGE_CONNECTIONSwith toolkitgooglephotos - Always call
RUBE_SEARCH_TOOLSfirst to get current tool schemas
Setup
Get 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.
- Verify Rube MCP is available by confirming
RUBE_SEARCH_TOOLSresponds - Call
RUBE_MANAGE_CONNECTIONSwith toolkitgooglephotos - If connection is not ACTIVE, follow the returned auth link to complete setup
- Confirm connection status shows ACTIVE before running any workflows
Core Workflows
1. List Albums
Use 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
2. Create a New Album
Use GOOGLEPHOTOS_CREATE_ALBUM to create a new album in Google Photos.
Tool: GOOGLEPHOTOS_CREATE_ALBUM
Parameters:
- title (required): Album title
3. Upload Media
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
4. Batch Upload and Create Media Items
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
5. Search Media Items
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
6. Add Items to an Album
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
Common Patterns
- Create album then upload: Use
GOOGLEPHOTOS_CREATE_ALBUMto create an album, thenGOOGLEPHOTOS_BATCH_CREATE_MEDIA_ITEMSwith the album ID to upload and organize photos in one step. - List then organize: Use
GOOGLEPHOTOS_SEARCH_MEDIA_ITEMSorGOOGLEPHOTOS_LIST_MEDIA_ITEMSto find media item IDs, thenGOOGLEPHOTOS_BATCH_ADD_MEDIA_ITEMSto add them to albums. - Update album metadata: Use
GOOGLEPHOTOS_UPDATE_ALBUMto change an album's title or cover photo. - Get album details: Use
GOOGLEPHOTOS_GET_ALBUMwith an album ID to retrieve full album information. - Add enrichments: Use
GOOGLEPHOTOS_ADD_ENRICHMENTto add text overlays, locations, or map enrichments to album positions. - Upload from URLs: Use the
urlparameter inGOOGLEPHOTOS_UPLOAD_MEDIAorurlsinGOOGLEPHOTOS_BATCH_CREATE_MEDIA_ITEMSto upload images directly from web URLs.
Known Pitfalls
GOOGLEPHOTOS_LIST_MEDIA_ITEMSis deprecated -- preferGOOGLEPHOTOS_SEARCH_MEDIA_ITEMSfor listing and filtering media.GOOGLEPHOTOS_UPLOAD_MEDIAsupports images up to 200MB and videos up to a larger limit. Exceeding these will fail.- Album IDs must be obtained from
GOOGLEPHOTOS_LIST_ALBUMSorGOOGLEPHOTOS_CREATE_ALBUMresponses -- they are opaque strings. GOOGLEPHOTOS_BATCH_ADD_MEDIA_ITEMScan only add items to albums created by the app or albums the user owns.- The
filtersparameter inGOOGLEPHOTOS_SEARCH_MEDIA_ITEMSuses a specific Google Photos API filter structure -- consult the schema for date range and content category formats. - Media items created via the API may not immediately appear in the Google Photos web UI due to processing delays.
Quick Reference
| 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
04 同仓库更多 Skills
x-article-draft-uploader
把本地 Markdown 转为经核验的 X Articles 新草稿。适用于需要保留首图封面、正文图片相对位置,并在独立 Playwright 会话中复用用户已授权 Chrome 登录态的任务;不负责公开发布。
wecom-operations
通过用户已配置的官方 wecom-cli 管理企业微信文档、智能文档、待办、会议和日程。适合创建或查询这些云端对象、把本地 Markdown 转为智能文档,以及在明确确认后更新或取消对象;不发送消息、不控制桌面客户端。
wecom-local-vault
Inspect authorized local WeCom databases on macOS, create private plaintext snapshots, and query or export contacts, conversations, and messages without modifying the source account store. Use when the user asks to parse 企业微信/WeCom local data, recover a private database snapshot, inspect local contacts or sessions, search chat history, or export a bounded conversation.
wechat-reading
Read and analyze WeRead/微信读书 search results, book metadata, bookshelf entries, progress, notes, highlights, public reviews, recommendations, and reading statistics through the official read-only Agent Gateway. Use for WeRead account questions or exports; do not imply that the current Gateway can add, remove, upload, rate, like, or edit content.
wechat-mp-batch-exporter
Build a bounded, private archive from known WeChat Official Account article URLs or an owner-authorized account-history export, with explicit reconciliation of article, publish-group, and platform-marked-original counts. Use for batch body capture, history normalization, or enhanced metrics/comments workflows. Do not use for a one-page summary or to automate the WeChat client.
wechat-local-vault
在 macOS 本机建立并查询私有微信数据快照。适用于盘点数据库、离线校验已有密钥候选、创建全量或增量明文快照、查会话与联系人、按时间检索消息、导出指定聊天、查看朋友圈或收藏,以及准备群聊摘要素材。所有查询只读,默认隐藏内部账号标识,不操控微信界面,也不发送任何内容。