Google Photos is a cloud-based photo storage and organization service offering automatic backups, AI-assisted search, and shared albums for personal and collaborative media management
Google Photos is a cloud-based photo storage and organization service offering automatic backups, AI-assisted search, and shared albums for personal and collaborative media management On Nagent, Google Photos is exposed as a fully-configurable images & design integration that any agent can call — 14 actions, and OAuth authentication. No code is required to wire Google Photos into your workflow — connect it once via the External Integrations panel and reuse it across every agent you build.
Agent builders use Google Photos to automate the kinds of tasks images & design teams previously handled manually. Concrete examples — each one is a single agent step in Nagent — include:
Every action and trigger is paired with a structured input/output schema (visible in the sections below), so when you wire Google Photos into Helix — our agentic agent builder — the editor knows exactly what each step expects and produces. Configure once, deploy anywhere across your Nagent agents.
Every operation an agent can call against Google Photos, with input parameters and output schema. Drop these into any step of an agent built in Helix.
GOOGLEPHOTOS_ADD_ENRICHMENTAdds an enrichment at a specified position in a defined album.
Input parameters
Identifier of the album where the enrichment is to be added
Position in the album where the enrichment is to be inserted. Required field with valid position types: FIRST_IN_ALBUM, LAST_IN_ALBUM, AFTER_MEDIA_ITEM (requires relativeMediaItemId), AFTER_ENRICHMENT_ITEM (requires relativeEnrichmentItemId)
The enrichment to be added, can be a text, location, or map enrichment
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GOOGLEPHOTOS_BATCH_ADD_MEDIA_ITEMSAdds one or more media items to an album in Google Photos.
Input parameters
Identifier of the Album that the media items are added to. Must be an album created by this application.
Identifiers of the MediaItems to be added. Maximum 50 items. Media items must be created by this application.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GOOGLEPHOTOS_BATCH_CREATE_MEDIA_ITEMSBatch upload and create media items in Google Photos. Supports three input methods: 1. 'urls': Simple list of public URLs (file names extracted automatically) 2. 'media_files': List of objects with url/file, file_name, and description 3. 'files': List of FileUploadable objects for pre-uploaded files Media items can optionally be added to an album at a specific position. Maximum 50 items per request.
Input parameters
Simplified input: List of public URLs of media files to upload. File names will be extracted from URLs automatically. Use 'media_files' for more control over file names and descriptions.
List of files to upload to Google Photos.
Optional identifier of the album where the media items are to be added. If not specified, media items are added to the user's library only.
List of media files to upload. Each item can specify either a 'url' (public URL) or a 'file' (FileUploadable object). Maximum 50 items per request.
Position in the album to add the media items.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GOOGLEPHOTOS_BATCH_GET_MEDIA_ITEMSReturns the list of media items for the specified media item identifiers.
Input parameters
Identifiers of the media items to be requested. Must not contain duplicates.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GOOGLEPHOTOS_CREATE_ALBUMCreates a new album in Google Photos.
Input parameters
Name of the album to be created in Google Photos. Maximum 500 characters.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GOOGLEPHOTOS_GET_ALBUMReturns the album based on the specified albumId.
Input parameters
Identifier of the album to be requested.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GOOGLEPHOTOS_GET_MEDIA_ITEM_DOWNLOADDownloads a media item from Google Photos and returns it as a file.
Input parameters
ID of the media item to download
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GOOGLEPHOTOS_LIST_ALBUMSLists all albums shown to a user in the Albums tab of Google Photos.
Input parameters
Maximum number of albums to return. Default 20, maximum 50.
Continuation token for getting the next page of results
If true, excludes media items not created by this app
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GOOGLEPHOTOS_LIST_MEDIA_ITEMSLists media items created by this application from Google Photos. DEPRECATION NOTICE: As of March 31, 2025, the Google Photos Library API ONLY returns media items that were uploaded/created by your application. This action CANNOT access the user's full photo library. Use cases this action SUPPORTS: - Listing photos/videos your app previously uploaded to the user's library - Managing app-created content in Google Photos Use cases this action DOES NOT SUPPORT: - Accessing photos taken by the user's camera - Viewing photos from other apps or web uploads - Listing the user's entire photo library For accessing a user's full library, use the Google Photos Picker API instead: https://developers.google.com/photos/picker
Input parameters
Maximum number of items to return. Default 25, maximum 100.
Token for getting the next page of results
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GOOGLEPHOTOS_LIST_SHARED_ALBUMS\[DEPRECATED - sunset March 31, 2025\] Lists all shared albums available in the Sharing tab of the user's Google Photos app. Use when you need to retrieve shared albums that are visible to the user in their Sharing tab.
Input parameters
Maximum number of albums to return. Default 20, maximum 50.
Continuation token for getting the next page of results. Use the value returned in nextPageToken from the previous response.
If true, excludes media items not created by this app. Defaults to false (all albums are returned). This field is ignored if the photoslibrary.readonly.appcreateddata scope is used.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GOOGLEPHOTOS_SEARCH_MEDIA_ITEMSSearches for media items in a user's Google Photos library.
Input parameters
Album to search within
Search filters
Sort order for results, e.g. 'MediaMetadata.creation_time desc'
Maximum number of items to return. Default 25, maximum 100.
Token for getting the next page
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GOOGLEPHOTOS_UPDATE_ALBUMUpdates an album's title or cover photo in Google Photos.
Input parameters
New title for the album. Maximum 500 characters.
Identifier of the album to update
ID of the media item to use as album cover photo
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GOOGLEPHOTOS_UPDATE_MEDIA_ITEMUpdates a media item's description in Google Photos.
Input parameters
New description for the media item. Must be shorter than 1000 characters.
Identifier of the media item to update
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GOOGLEPHOTOS_UPLOAD_MEDIAUpload a media file to Google Photos. Supports images (up to 200MB) and videos (up to 20GB).
Input parameters
Public URL of the media file to upload (must be directly accessible). The action will download the file from this URL and upload it to Google Photos. Alternative to 'file_to_upload'. Supported formats: images (JPEG, PNG, GIF, HEIC, etc.) and videos (MP4, MOV, etc.).
File name for the uploaded media. Required when using 'url' parameter. Should include the file extension (e.g., 'photo.jpg', 'video.mp4').
Optional description for the media item
The media file to upload to Google Photos.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
No publicly available marketplace agent is found using this tool yet. There are 80 agents privately built on Nagent that already use Google Photos.
Build on Nagent
Connect Google Photos to any Nagent agent in minutes — no API key management, no boilerplate. Just configure and deploy.
The five questions agent builders ask before adopting a new integration.
Open the External Integrations panel inside Nagent (app.nagent.ai/externalIntegration), find Google Photos, and click "Connect Now." You'll authenticate with OAuth — Nagent handles credential storage and refresh automatically. Once connected, Google Photos is available to any agent in your workspace.
No. Nagent provides no-code integration for every tool. Once Google Photos is connected, you configure its 14 actions directly in the agent builder UI — no API calls, no boilerplate, no schema management.
Helix — Nagent's agentic agent builder — lets you drop Google Photos steps into any workflow visually. Pick an action (e.g., one of those listed above), fill in the inputs (Helix knows the required vs. optional schema for each parameter), and connect it to upstream/downstream steps. Triggers run as the entry point of an agent, so when a Google Photos event fires, the agent kicks off automatically.
Every Google Photos action and trigger ships with a fully-typed schema — input parameters with name, type, required flag, and description, plus the output payload shape. The schemas are documented in the sections above. Helix uses these schemas to validate your configuration at build time and to type-check the data flowing between steps.
Yes. While Google Photos ships with 14 pre-built images & design actions, you can layer custom logic around them inside Helix — pre/post-processing steps, conditional branches, retries, or stitching Google Photos together with other connected tools. For deeper customization, talk to our team about Nagent's Agentic AI Lab — forward-deployed engineers who build Google Photos-based workflows tailored to your business.