Google Photos MCP Server의 개요
Google은 2025년 3월 31일, 서드파티 Google Photos 도구가 할 수 있는 일을 바꿨습니다. Library API에서 photoslibrary.readonly, photoslibrary.sharing, photoslibrary 범위를 없앴기 때문에, 앱은 이제 자신이 직접 만든 앨범과 미디어 항목만 나열하고 검색하고 가져올 수 있습니다. 공유 앨범 메서드는 403을 돌려줍니다. 사용자의 더 넓은 라이브러리를 읽으려면 앱은 Picker API를 써야 하며, 이때 사람이 Google 페이지를 열고 항목을 직접 골라야 합니다.
이 커뮤니티 서버(savethepolarbears/google-photos-mcp, GitHub 스타 약 56개)는 이런 규칙을 전제로 만들어졌습니다. 도구는 21개입니다. Library API에서 동작하는 검색 및 앨범 도구, 업로드 및 앨범 생성 도구, 그리고 세션을 만들고 상태를 확인하고 선택된 항목을 내려받는 Picker 도구 4개가 있습니다. git clone으로 받아 stdio나 Streamable HTTP로 실행하거나 Smithery를 통해 실행하며, OAuth 자격 증명이 있는 자신의 Google Cloud 프로젝트가 필요합니다. 태그가 붙은 릴리스는 없습니다. package.json에는 MIT 라이선스의 버전 0.1.0으로 되어 있지만 저장소에 라이선스 파일은 없습니다.
Google Photos MCP Server 설치 방법
git clone https://github.com/savethepolarbears/google-photos-mcp && npm install && npm run buildGoogle Photos MCP Server, 쓸 만한 가치가 있습니까?
여기서 한계는 이 서버가 아니라 Google에서 옵니다. 2025년 3월 31일 이후 Library API는 앱이 직접 올린 미디어만 봅니다. 그래서 search_photos, search_photos_by_location, search_media_by_filter라는 이름의 도구는 대부분의 사람에게 거의 빈 집합, 즉 이 서버가 올려 둔 것만 검색합니다. README의 기능 표는 텍스트 검색과 날짜 검색을 지원한다고 표시하면서 이 점을 분명히 밝히지 않습니다. README의 예시에도 나오는 "2024년에 찍은 우리 개 사진 찾아 줘" 같은 요청은 휴대폰으로 찍은 사진에 닿지 못합니다.
Picker API 경로는 작동하지만 사람을 다시 과정 안으로 불러들입니다. 에이전트가 create_picker_session을 호출하면 사용자가 브라우저에서 링크를 열고 사진을 선택합니다. 그러면 에이전트가 상태를 확인하고 선택된 것을 내려받습니다. 이미지는 원본 해상도로, 동영상은 트랜스코딩된 MP4로 받습니다. "이 사진 30장으로 앨범을 만들어 줘" 같은 일에는 맞습니다. 에이전트가 스스로 무언가를 찾아 나서는 일에는 맞지 않습니다.
엔지니어링은 스타 수가 주는 인상보다 신중합니다. 토큰 유출을 막기 위해 다운로드는 Google 미디어 도메인으로 제한됩니다. OAuth 토큰은 소유자만 접근할 수 있는 권한의 로컬 SQLite 파일에 저장되고, localhost를 노린 무단 요청을 막기 위해 CORS가 꺼져 있으며, base64 응답은 10 MB로 제한됩니다. 위치 결과는 사진 설명을 OpenStreetMap의 Nominatim으로 지오코딩해 얻으므로, 그 텍스트는 사용자의 컴퓨터 밖으로 나갑니다.
설정이 또 다른 비용입니다. Google Cloud 프로젝트를 만들고, API 2개를 활성화하고, OAuth 웹 자격 증명을 만들고, stdio로 바꾸기 전에 HTTP 모드에서 로그인을 마쳐야 합니다. Library API는 프로젝트당 하루 10,000건의 요청을 허용합니다. npm 패키지도 릴리스도 없으므로, 업데이트하려면 저장소를 다시 받아야 합니다.
제 역할을 하는 곳
편집한 사진을 고객에게 전달하는 웨딩 사진작가
완성된 이미지 폴더를 이름을 붙인 새 앨범에 올리기
create_album_with_media는 호출당 최대 50개 파일을 앱이 만든 앨범에 올리며, 서버는 이후 그 앨범을 관리할 수 있습니다. 하루 10,000건의 요청 할당량 안에서는 무료입니다. 업로드는 원본 화질로 계정 소유자의 Google 저장 용량을 차지합니다.
연말 가족 앨범을 만드는 부모
휴대폰 라이브러리에서 사진 40장을 골라 에이전트가 설명을 달고 순서를 정하게 하기
에이전트가 Picker 세션을 열면 부모가 Google의 페이지에서 사진을 고르고, download_picker_media가 모델이 설명할 수 있도록 원본을 가져옵니다. 모델이 보는 모든 사진은 모델 제공업체로 전송됩니다.
에이전트 제품의 사진 연동을 검토하는 개발자
2025년 API 변경 이후 Google Photos 도구가 아직 할 수 있는 일 확인하기
README와 도구 목록은 남은 기능 범위를 분명하게 보여 줍니다. appendonly 업로드, 앱이 만든 항목 읽기, Picker입니다. 공유 앨범과 라이브러리 전체 검색은 이 서버뿐 아니라 모든 서드파티 앱에서 사라졌습니다.
도입 전 확인할 점
- 설정
- Node.js 22.22+에서 git clone, npm install, npm run build를 실행한 뒤, Google Cloud 프로젝트에서 Photos Library API와 Google Photos Picker API를 활성화하고 OAuth 웹 자격 증명을 만들어 http://localhost:3000/auth 에서 한 번 로그인합니다. 처음 실행까지 20~30분을 잡으십시오.
- 연동
- 도구 21개: 검색 및 탐색 9개, 쓰기 및 앨범 6개, Picker 4개, 인증 2개이며, MCP 리소스 3개와 프롬프트 3개가 있습니다. Claude Desktop, Cursor, MCP Inspector용으로 문서화되어 있습니다.
- 데이터와 개인정보
- OAuth 토큰은 소유자 전용 권한으로 로컬의 tokens.db에 저장됩니다. 미디어 URL은 Google 도메인으로 제한됩니다. 사진 설명은 OpenStreetMap Nominatim으로 지오코딩됩니다. base64로 가져온 이미지는 모델 제공업체로 갑니다.
- 대규모 사용 시 비용
- 무료입니다. Google은 프로젝트당 하루 Library API 요청 10,000건과 미디어 바이트 요청 75,000건을 허용하며, Picker API는 분당 100,000건을 허용합니다. 더 높은 할당량에는 Google의 파트너 프로그램이 필요합니다.
- 제한
- Google에 따르면 Library API 읽기는 앱이 만든 항목만 대상으로 하고, 공유 앨범은 403을 돌려줍니다. 동영상은 원본이 아니라 트랜스코딩된 MP4로 내려받습니다. 공개된 릴리스나 변경 기록이 없습니다.
좋은 점
- 사용자의 전체 라이브러리에 접근하는 유일한 공식 경로인 Picker API를 씁니다
- 호출당 최대 50개 파일로 업로드와 앨범 구성을 합니다
- 도메인 허용 목록, 0600 권한의 토큰 저장, CORS 없음
- 도구 21개와 MCP 리소스, 프롬프트
아쉬운 점
- 검색 도구는 서버가 올린 사진만 봅니다
- Picker 흐름에서는 사람이 브라우저에서 사진을 골라야 합니다
- 자신의 Google Cloud 프로젝트와 OAuth 설정이 필요합니다
- 릴리스나 npm 패키지가 없고 스타는 약 56개입니다
추천 대상
기존 라이브러리를 검색하는 것이 아니라, 에이전트에게 앨범을 올리고 정리하게 하거나 직접 고른 사진을 처리하게 하려는 사람입니다.
Google Photos MCP Server 대안
Google Photos MCP Server: 자주 묻는 질문
- Google Photos MCP Server, 쓸 만한 가치가 있습니까?
- Google이 닫아 버린 API를 중심으로 신중하게 만든 서버입니다. 업로드와 정리는 할 수 있지만, 에이전트는 더 이상 사용자가 실제로 찍은 사진을 검색할 수 없습니다. 평점은 5점 만점에 2.8점입니다.
- Google Photos MCP Server의 가격은 얼마입니까?
- 무료 오픈소스입니다(package.json 기준 MIT). Google Photos API는 할당량 안에서 무료입니다.
- Google Photos MCP Server의 단점은 무엇입니까?
- 검색 도구는 서버가 올린 사진만 봅니다; Picker 흐름에서는 사람이 브라우저에서 사진을 골라야 합니다; 자신의 Google Cloud 프로젝트와 OAuth 설정이 필요합니다; 릴리스나 npm 패키지가 없고 스타는 약 56개입니다.
- Google Photos MCP Server에 적합한 사람은 누구입니까?
- 기존 라이브러리를 검색하는 것이 아니라, 에이전트에게 앨범을 올리고 정리하게 하거나 직접 고른 사진을 처리하게 하려는 사람입니다.
- 팀이나 프로덕션 환경에서 Google Photos MCP Server의 비용은 얼마입니까?
- 무료입니다. Google은 프로젝트당 하루 Library API 요청 10,000건과 미디어 바이트 요청 75,000건을 허용하며, Picker API는 분당 100,000건을 허용합니다. 더 높은 할당량에는 Google의 파트너 프로그램이 필요합니다.
- Google Photos MCP Server에 회사 데이터를 맡겨도 안전합니까?
- OAuth 토큰은 소유자 전용 권한으로 로컬의 tokens.db에 저장됩니다. 미디어 URL은 Google 도메인으로 제한됩니다. 사진 설명은 OpenStreetMap Nominatim으로 지오코딩됩니다. base64로 가져온 이미지는 모델 제공업체로 갑니다.
- Google Photos MCP Server의 가장 좋은 대안은 무엇입니까?
- 저희가 리뷰한 것 중 가장 가까운 대안은 Google Workspace MCP servers 및 Filesystem (reference server)입니다.
답변 확인일: 2026년 10월 31일.
