O que é Google Photos MCP Server?
O Google mudou o que qualquer ferramenta de terceiros para o Google Fotos pode fazer em 31 de março de 2025. Ele removeu os escopos photoslibrary.readonly, photoslibrary.sharing e photoslibrary da Library API, então os apps agora só podem listar, buscar e recuperar os álbuns e itens de mídia que eles mesmos criaram. Os métodos de álbuns compartilhados retornam 403. Para ler a biblioteca mais ampla de um usuário, o app precisa usar a Picker API, em que a pessoa abre uma página do Google e escolhe os itens à mão.
Este servidor da comunidade (savethepolarbears/google-photos-mcp, cerca de 56 estrelas no GitHub) é construído em torno dessas regras. Ele expõe 21 ferramentas: ferramentas de busca e de álbuns que rodam na Library API, ferramentas de upload e criação de álbuns e quatro ferramentas do Picker que criam uma sessão, consultam seu andamento e baixam os itens escolhidos. Ele roda a partir de um git clone via stdio ou Streamable HTTP, ou pelo Smithery, e exige seu próprio projeto do Google Cloud com credenciais OAuth. Não há releases com tag; o package.json indica a versão 0.1.0 sob MIT, embora o repositório não tenha arquivo de licença.
Como instalar Google Photos MCP Server
git clone https://github.com/savethepolarbears/google-photos-mcp && npm install && npm run buildGoogle Photos MCP Server vale a pena?
O limite aqui vem do Google, não deste servidor. Desde 31 de março de 2025, a Library API só vê mídia que o próprio app enviou. As ferramentas chamadas search_photos, search_photos_by_location e search_media_by_filter, portanto, buscam em um conjunto quase vazio para a maioria das pessoas: o que este servidor colocou lá. A tabela de recursos do README marca a busca por texto e por data como suportadas sem deixar isso claro. Um pedido como "encontre fotos do meu cachorro de 2024", que aparece nos próprios exemplos, não vai alcançar fotos tiradas com o celular.
O caminho pela Picker API funciona, mas coloca uma pessoa de volta no circuito. O agente chama create_picker_session, você abre o link no navegador e marca as fotos. Depois, o agente consulta o andamento e baixa o que você escolheu, como imagens em resolução total ou MP4 transcodificado no caso de vídeo. Isso serve para "transforme estas 30 fotos em um álbum". Não serve para um agente que sai procurando coisas por conta própria.
A engenharia é mais cuidadosa do que o número de estrelas sugere. Os downloads ficam restritos a domínios de mídia do Google para impedir a exfiltração de tokens. Os tokens OAuth ficam em um arquivo SQLite local com permissões só para o dono, o CORS fica desativado para bloquear requisições oportunistas ao localhost e as respostas em base64 têm limite de 10 MB. Os resultados por localização vêm da geocodificação das descrições das fotos pelo Nominatim do OpenStreetMap, então esse texto sai da sua máquina.
A configuração é o outro custo. Você cria um projeto do Google Cloud, habilita duas APIs, gera credenciais OAuth web e conclui o login no modo HTTP antes de mudar para stdio. A Library API permite 10.000 requisições por projeto por dia. Sem pacote npm e sem releases, atualizar significa puxar o repositório de novo.
Onde ele se destaca
Um fotógrafo de casamentos entregando fotos editadas aos clientes
Enviar uma pasta de imagens finalizadas para um novo álbum com nome
O create_album_with_media envia até 50 arquivos por chamada para um álbum criado pelo app, que o servidor pode então gerenciar. Gratuito dentro da cota de 10.000 requisições por dia; os uploads contam no armazenamento do Google do dono da conta na qualidade original.
Uma mãe montando um álbum de família de fim de ano
Escolher 40 fotos da biblioteca do celular e pedir ao agente que as legende e ordene
O agente abre uma sessão do Picker, a mãe seleciona as fotos na própria página do Google e o download_picker_media busca os originais para o modelo descrever. Cada foto que o modelo examina é enviada ao provedor dele.
Um desenvolvedor avaliando integrações de fotos para um produto com agentes
Verificar o que uma ferramenta para o Google Fotos ainda consegue fazer depois da mudança de API de 2025
O README e a lista de ferramentas são um mapa claro da superfície que restou: uploads appendonly, leitura de itens criados pelo app e o Picker. Álbuns compartilhados e busca na biblioteca inteira acabaram para todo app de terceiros, não só para este.
Antes de decidir
- Configuração
- git clone, npm install e npm run build no Node.js 22.22+; depois, habilite a Photos Library API e a Google Photos Picker API em um projeto do Google Cloud, crie credenciais OAuth web e faça login uma vez por http://localhost:3000/auth. Reserve de 20 a 30 minutos para a primeira execução.
- Integrações
- 21 ferramentas: nove de busca e navegação, seis de escrita e álbuns, quatro do Picker e duas de autenticação, além de três resources MCP e três prompts. Documentado para Claude Desktop, Cursor e o MCP Inspector.
- Dados e privacidade
- Os tokens OAuth ficam guardados localmente em tokens.db com permissões só para o dono. As URLs de mídia são limitadas a domínios do Google. As descrições das fotos são geocodificadas pelo Nominatim do OpenStreetMap. Imagens que você busca em base64 vão para o seu provedor de modelo.
- Custo em escala
- Gratuito. O Google permite 10.000 requisições à Library API e 75.000 requisições de bytes de mídia por projeto por dia; a Picker API permite 100.000 requisições por minuto. Cota maior exige o programa de parceiros do Google.
- Limites
- As leituras da Library API cobrem só itens criados pelo app e álbuns compartilhados retornam 403, segundo o Google. Vídeos são baixados como MP4 transcodificado, não os originais. Não há release nem changelog publicados.
O que é bom
- Usa a Picker API, o único caminho suportado para a biblioteca completa de um usuário
- Uploads e montagem de álbuns com até 50 arquivos por chamada
- Lista de domínios permitidos, armazenamento de tokens com permissão 0600 e sem CORS
- 21 ferramentas, além de resources e prompts MCP
O que não é
- As ferramentas de busca só veem fotos que o servidor enviou
- O fluxo do Picker exige que uma pessoa escolha as fotos no navegador
- Exige projeto próprio no Google Cloud e configuração de OAuth
- Sem releases nem pacote npm; cerca de 56 estrelas
Ideal para
Quem quer que um agente envie fotos e organize álbuns, ou processe fotos escolhidas à mão, e não que busque em uma biblioteca existente.
Alternativas ao Google Photos MCP Server
Google Photos MCP Server: perguntas frequentes
- Google Photos MCP Server vale a pena?
- Uma construção cuidadosa em torno de uma API que o Google fechou: ele consegue enviar e organizar, mas um agente não pode mais buscar as fotos que você realmente tirou. Damos nota 2.8 de 5.
- Quanto custa Google Photos MCP Server?
- Gratuito e de código aberto (MIT segundo o package.json). As APIs do Google Fotos são gratuitas dentro da cota.
- Quais são as desvantagens de Google Photos MCP Server?
- As ferramentas de busca só veem fotos que o servidor enviou; o fluxo do Picker exige que uma pessoa escolha as fotos no navegador; exige projeto próprio no Google Cloud e configuração de OAuth; sem releases nem pacote npm; cerca de 56 estrelas.
- Para quem Google Photos MCP Server é indicado?
- Quem quer que um agente envie fotos e organize álbuns, ou processe fotos escolhidas à mão, e não que busque em uma biblioteca existente.
- Quanto custa Google Photos MCP Server para uma equipe ou em produção?
- Gratuito. O Google permite 10.000 requisições à Library API e 75.000 requisições de bytes de mídia por projeto por dia; a Picker API permite 100.000 requisições por minuto. Cota maior exige o programa de parceiros do Google.
- Google Photos MCP Server é seguro para dados da empresa?
- Os tokens OAuth ficam guardados localmente em tokens.db com permissões só para o dono. As URLs de mídia são limitadas a domínios do Google. As descrições das fotos são geocodificadas pelo Nominatim do OpenStreetMap. Imagens que você busca em base64 vão para o seu provedor de modelo.
- Quais são as melhores alternativas ao Google Photos MCP Server?
- As alternativas mais próximas que analisamos são Google Workspace MCP servers e Filesystem (reference server).
Respostas verificadas em 31 de out. de 2026.