> ## Documentation Index
> Fetch the complete documentation index at: https://docs.boxd.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Photos

> 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 managem

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

`googlephotos` · **14 tools** · no triggers

## Connect it

```bash theme={"theme":"github-dark"}
run auth googlephotos
run auth googlephotos --scope team    # shared with the organization
```

Or from the [Integrations page](https://app.boxd.sh/integrations) in the console. See [Connections](/guides/integrations/connections) for personal versus shared, and who may remove one.

## Use it

```bash theme={"theme":"github-dark"}
run googlephotos          # common commands
run googlephotos --all    # every command
```

```ts theme={"theme":"github-dark"}
import { googlephotos } from "@boxd/run";
```

## Common tools

| Tool                       | What it does                                                                                                                                       |
| -------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| `add-enrichment`           | Adds an enrichment at a specified position in a defined album.                                                                                     |
| `batch-add-media-items`    | Adds one or more media items to an album in Google Photos.                                                                                         |
| `batch-create-media-items` | Batch upload and create media items in Google Photos. Supports three input methods: 1. 'urls': Simple list of public URLs (file names extracted... |
| `batch-get-media-items`    | Returns the list of media items for the specified media item identifiers.                                                                          |
| `create-album`             | Creates a new album in Google Photos.                                                                                                              |

<Accordion title="All 14 tools" icon="list">
  | Tool                       | What it does                                                                                                                                       |
  | -------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
  | `add-enrichment`           | Adds an enrichment at a specified position in a defined album.                                                                                     |
  | `batch-add-media-items`    | Adds one or more media items to an album in Google Photos.                                                                                         |
  | `batch-create-media-items` | Batch upload and create media items in Google Photos. Supports three input methods: 1. 'urls': Simple list of public URLs (file names extracted... |
  | `batch-get-media-items`    | Returns the list of media items for the specified media item identifiers.                                                                          |
  | `create-album`             | Creates a new album in Google Photos.                                                                                                              |
  | `get-album`                | Returns the album based on the specified albumId.                                                                                                  |
  | `get-media-item-download`  | Downloads a media item from Google Photos and returns it as a file.                                                                                |
  | `list-albums`              | Lists all albums shown to a user in the Albums tab of Google Photos.                                                                               |
  | `list-media-items`         | Lists media items created by this application from Google Photos.                                                                                  |
  | `list-shared-albums`       | \[DEPRECATED - sunset March 31, 2025] Lists all shared albums available in the Sharing tab of the user's Google Photos app.                        |
  | `search-media-items`       | Searches for media items in a user's Google Photos library.                                                                                        |
  | `update-album`             | Updates an album's title or cover photo in Google Photos.                                                                                          |
  | `update-media-item`        | Updates a media item's description in Google Photos.                                                                                               |
  | `upload-media`             | Upload a media file to Google Photos. Supports images (up to 200MB) and videos (up to 20GB).                                                       |
</Accordion>

[Open Google Photos in the console →](https://app.boxd.sh/integrations/detail/googlephotos)