¿Qué es Google Photos MCP Server?
Google cambió lo que puede hacer cualquier herramienta de terceros para Google Photos el 31 de marzo de 2025. Retiró los scopes photoslibrary.readonly, photoslibrary.sharing y photoslibrary de la Library API, así que ahora las apps solo pueden listar, buscar y recuperar los álbumes y elementos que ellas mismas crearon. Los métodos de álbumes compartidos devuelven 403. Para leer la biblioteca completa de un usuario, una app tiene que usar la Picker API, en la que la persona abre una página de Google y elige los elementos a mano.
Este servidor comunitario (savethepolarbears/google-photos-mcp, unas 56 estrellas en GitHub) está construido en torno a esas reglas. Expone 21 herramientas: herramientas de búsqueda y álbumes que funcionan sobre la Library API, herramientas de subida y creación de álbumes, y cuatro herramientas de Picker que crean una sesión, la consultan y descargan los elementos elegidos. Se ejecuta desde un git clone por stdio o Streamable HTTP, o a través de Smithery, y necesita tu propio proyecto de Google Cloud con credenciales OAuth. No hay versiones etiquetadas; package.json indica la versión 0.1.0 bajo MIT, aunque el repositorio no tiene archivo de licencia.
Cómo instalar Google Photos MCP Server
git clone https://github.com/savethepolarbears/google-photos-mcp && npm install && npm run build¿Merece la pena Google Photos MCP Server?
El límite aquí viene de Google, no de este servidor. Desde el 31 de marzo de 2025, la Library API solo ve el contenido que una app subió por sí misma. Por eso las herramientas llamadas search_photos, search_photos_by_location y search_media_by_filter buscan, para la mayoría de la gente, en un conjunto casi vacío: lo que este servidor haya puesto allí. La tabla de capacidades del README marca la búsqueda por texto y por fecha como compatible sin dejarlo claro. Una petición como "encuentra fotos de mi perro de 2024", que aparece en sus propios ejemplos, no llegará a las fotos hechas con un móvil.
La vía de la Picker API funciona, pero vuelve a meter a una persona en el proceso. El agente llama a create_picker_session y tú abres el enlace en un navegador y marcas fotos. Después el agente consulta y descarga lo que elegiste, como imágenes a resolución completa o MP4 transcodificado en el caso del vídeo. Eso encaja con "convierte estas 30 fotos en un álbum". No encaja con un agente que sale a buscar cosas por su cuenta.
La ingeniería es más cuidadosa de lo que sugiere el número de estrellas. Las descargas se limitan a dominios de medios de Google para evitar la exfiltración de tokens. Los tokens OAuth se guardan en un archivo SQLite local con permisos solo para el propietario, CORS está desactivado para bloquear peticiones encubiertas a localhost, y las respuestas en base64 tienen un tope de 10 MB. Los resultados por ubicación salen de geocodificar las descripciones de las fotos con Nominatim de OpenStreetMap, así que ese texto sale de tu máquina.
La configuración es el otro coste. Creas un proyecto de Google Cloud, activas dos APIs, generas credenciales web de OAuth y completas el inicio de sesión en modo HTTP antes de pasar a stdio. La Library API permite 10.000 peticiones por proyecto y día. Sin paquete npm y sin versiones, actualizar significa volver a hacer pull del repositorio.
Dónde se gana su sitio
Un fotógrafo de bodas que entrega fotos editadas a sus clientes
Subir una carpeta de imágenes terminadas a un álbum nuevo con nombre
create_album_with_media sube hasta 50 archivos por llamada a un álbum creado por la app que el servidor puede gestionar después. Gratis dentro de la cuota de 10.000 peticiones al día; las subidas consumen el almacenamiento de Google del titular de la cuenta en calidad original.
Una madre o un padre que prepara el álbum familiar de fin de año
Elegir 40 fotos de la biblioteca del móvil y que el agente las describa y ordene
El agente abre una sesión de Picker, la persona selecciona las fotos en la propia página de Google y download_picker_media descarga los originales para que el modelo los describa. Cada foto que mira el modelo se envía a su proveedor.
Un desarrollador que evalúa integraciones de fotos para un producto con agentes
Comprobar qué puede hacer todavía una herramienta de Google Photos tras el cambio de API de 2025
El README y la lista de herramientas son un mapa claro de lo que queda: subidas appendonly, lecturas de contenido creado por la app y el Picker. Los álbumes compartidos y la búsqueda en toda la biblioteca han desaparecido para todas las apps de terceros, no solo para esta.
Antes de decidirte
- Puesta en marcha
- git clone, npm install y npm run build en Node.js 22.22+, después activa la Photos Library API y la Google Photos Picker API en un proyecto de Google Cloud, crea credenciales web de OAuth e inicia sesión una vez en http://localhost:3000/auth. Calcula de 20 a 30 minutos para la primera vez.
- Integraciones
- 21 herramientas: nueve de búsqueda y navegación, seis de escritura y álbumes, cuatro de Picker y dos de autenticación, más tres recursos MCP y tres prompts. Documentado para Claude Desktop, Cursor y el MCP Inspector.
- Datos y privacidad
- Los tokens OAuth se guardan localmente en tokens.db con permisos solo para el propietario. Las URL de medios se limitan a dominios de Google. Las descripciones de las fotos se geocodifican con Nominatim de OpenStreetMap. Las imágenes que obtienes en base64 van a tu proveedor de modelos.
- Coste a escala
- Gratis. Google permite 10.000 peticiones a la Library API y 75.000 peticiones de bytes de medios por proyecto y día; la Picker API permite 100.000 peticiones por minuto. Una cuota mayor requiere el programa de partners de Google.
- Límites
- Las lecturas de la Library API cubren solo elementos creados por la app y los álbumes compartidos devuelven 403, según Google. Los vídeos se descargan como MP4 transcodificado, no como originales. No hay versión publicada ni registro de cambios.
Lo bueno
- Usa la Picker API, la única vía admitida a la biblioteca completa de un usuario
- Subidas y creación de álbumes con hasta 50 archivos por llamada
- Lista de dominios permitidos, almacenamiento de tokens 0600 y sin CORS
- 21 herramientas, más recursos y prompts MCP
Lo malo
- Las herramientas de búsqueda solo ven las fotos que subió el servidor
- El flujo de Picker necesita que una persona elija las fotos en un navegador
- Exige proyecto propio de Google Cloud y configuración de OAuth
- Sin versiones ni paquete npm; unas 56 estrellas
Ideal para
Quien quiera que un agente suba y ordene álbumes, o procese fotos elegidas a mano, no que busque en una biblioteca existente.
Alternativas a Google Photos MCP Server
Google Photos MCP Server: preguntas frecuentes
- ¿Merece la pena Google Photos MCP Server?
- Una construcción cuidadosa en torno a una API que Google ha cerrado: puede subir y organizar, pero un agente ya no puede buscar en las fotos que tú hiciste. Le damos un 2.8 sobre 5.
- ¿Cuánto cuesta Google Photos MCP Server?
- Gratuito y de código abierto (MIT según package.json). Las APIs de Google Photos son gratuitas dentro de la cuota.
- ¿Qué inconvenientes tiene Google Photos MCP Server?
- Las herramientas de búsqueda solo ven las fotos que subió el servidor; el flujo de Picker necesita que una persona elija las fotos en un navegador; exige proyecto propio de Google Cloud y configuración de OAuth; sin versiones ni paquete npm; unas 56 estrellas.
- ¿Para quién es Google Photos MCP Server?
- Quien quiera que un agente suba y ordene álbumes, o procese fotos elegidas a mano, no que busque en una biblioteca existente.
- ¿Cuánto cuesta Google Photos MCP Server para un equipo o en producción?
- Gratis. Google permite 10.000 peticiones a la Library API y 75.000 peticiones de bytes de medios por proyecto y día; la Picker API permite 100.000 peticiones por minuto. Una cuota mayor requiere el programa de partners de Google.
- ¿Es Google Photos MCP Server seguro para los datos de la empresa?
- Los tokens OAuth se guardan localmente en tokens.db con permisos solo para el propietario. Las URL de medios se limitan a dominios de Google. Las descripciones de las fotos se geocodifican con Nominatim de OpenStreetMap. Las imágenes que obtienes en base64 van a tu proveedor de modelos.
- ¿Cuáles son las mejores alternativas a Google Photos MCP Server?
- Las alternativas más cercanas que hemos analizado son Google Workspace MCP servers y Filesystem (reference server).
Respuestas comprobadas el 31 oct 2026.