Automação do Google Photos com Rube MCP

Faça upload de fotos, gerencie álbuns, pesquise itens de mídia e organize conteúdo em lote no Google Photos usando Rube MCP (Composio).

Documentação do Toolkit: composio.dev/toolkits/googlephotos

Pré-requisitos

• Rube MCP deve estar conectado (RUBE_SEARCH_TOOLS disponível)
• Conexão ativa via RUBE_MANAGE_CONNECTIONS com o toolkit googlephotos
• Sempre chame RUBE_SEARCH_TOOLS primeiro para obter os esquemas de ferramentas atuais

Configuração

Obtenha o Rube MCP: Adicione https://rube.app/mcp como um servidor MCP na configuração do seu cliente. Nenhuma chave de API é necessária — basta adicionar o endpoint e funciona.

1. Verifique se o Rube MCP está disponível confirmando que RUBE_SEARCH_TOOLS responde
2. Chame RUBE_MANAGE_CONNECTIONS com o toolkit googlephotos
3. Se a conexão não estiver ATIVA, siga o link de autenticação retornado para concluir a configuração
4. Confirme se o status da conexão mostra ATIVA antes de executar quaisquer fluxos de trabalho

Fluxos de Trabalho Principais

1. Listar Álbuns

Use GOOGLEPHOTOS_LIST_ALBUMS para recuperar todos os álbuns visíveis na aba Álbuns do usuário.

Tool: GOOGLEPHOTOS_LIST_ALBUMS
Parameters:
  - pageSize: Number of albums per page
  - pageToken: Pagination token
  - excludeNonAppCreatedData: Only show albums created by this app

2. Criar um Novo Álbum

Use GOOGLEPHOTOS_CREATE_ALBUM para criar um novo álbum no Google Photos.

Tool: GOOGLEPHOTOS_CREATE_ALBUM
Parameters:
  - title (required): Album title

3. Fazer Upload de Mídia

Use GOOGLEPHOTOS_UPLOAD_MEDIA para fazer upload de um arquivo de imagem ou vídeo para o 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. Fazer Upload em Lote e Criar Itens de Mídia

Use GOOGLEPHOTOS_BATCH_CREATE_MEDIA_ITEMS para fazer upload de vários arquivos e criar itens de mídia em uma única operação.

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. Pesquisar Itens de Mídia

Use GOOGLEPHOTOS_SEARCH_MEDIA_ITEMS para pesquisar a biblioteca de fotos do usuário com filtros.

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. Adicionar Itens a um Álbum

Use GOOGLEPHOTOS_BATCH_ADD_MEDIA_ITEMS para adicionar itens de mídia existentes a um álbum.

Tool: GOOGLEPHOTOS_BATCH_ADD_MEDIA_ITEMS
Parameters:
  - albumId (required): Target album ID
  - mediaItemIds (required): Array of media item IDs to add

Padrões Comuns

• Criar álbum e depois fazer upload: Use GOOGLEPHOTOS_CREATE_ALBUM para criar um álbum, depois GOOGLEPHOTOS_BATCH_CREATE_MEDIA_ITEMS com o ID do álbum para fazer upload e organizar fotos em uma única etapa.
• Listar e depois organizar: Use GOOGLEPHOTOS_SEARCH_MEDIA_ITEMS ou GOOGLEPHOTOS_LIST_MEDIA_ITEMS para encontrar IDs de itens de mídia, depois GOOGLEPHOTOS_BATCH_ADD_MEDIA_ITEMS para adicioná-los a álbuns.
• Atualizar metadados do álbum: Use GOOGLEPHOTOS_UPDATE_ALBUM para alterar o título ou a foto de capa de um álbum.
• Obter detalhes do álbum: Use GOOGLEPHOTOS_GET_ALBUM com um ID de álbum para recuperar informações completas do álbum.
• Adicionar enriquecimentos: Use GOOGLEPHOTOS_ADD_ENRICHMENT para adicionar sobreposições de texto, locais ou enriquecimentos de mapa a posições de álbuns.
• Fazer upload de URLs: Use o parâmetro url em GOOGLEPHOTOS_UPLOAD_MEDIA ou urls em GOOGLEPHOTOS_BATCH_CREATE_MEDIA_ITEMS para fazer upload de imagens diretamente de URLs da web.

Armadilhas Conhecidas

• GOOGLEPHOTOS_LIST_MEDIA_ITEMS está obsoleto — prefira GOOGLEPHOTOS_SEARCH_MEDIA_ITEMS para listar e filtrar mídia.
• GOOGLEPHOTOS_UPLOAD_MEDIA suporta imagens de até 200MB e vídeos de até um limite maior. Exceder esses limites resultará em falha.
• IDs de álbuns devem ser obtidos das respostas de GOOGLEPHOTOS_LIST_ALBUMS ou GOOGLEPHOTOS_CREATE_ALBUM — são strings opacas.
• GOOGLEPHOTOS_BATCH_ADD_MEDIA_ITEMS só pode adicionar itens a álbuns criados pelo aplicativo ou álbuns que o usuário possui.
• O parâmetro filters em GOOGLEPHOTOS_SEARCH_MEDIA_ITEMS usa uma estrutura de filtro específica da API do Google Photos — consulte o esquema para formatos de intervalo de datas e categorias de conteúdo.

…