Gmail MCP

Gmail API에 대한 MCP(모델 컨텍스트 프로토콜) 구현으로, 이메일 관리, 전송 및 검색을 위한 표준화된 인터페이스를 제공합니다.

특징

• 메시지, 스레드, 라벨, 초안 및 설정을 포함한 Gmail API 전체 적용 범위
• 이메일 보내기, 초안 작성 및 관리 지원
• 사용자 정의 가능한 색상 및 가시성 설정을 통한 라벨 관리
• 대화 관리를 위한 스레드 작업
• 휴가 응답, IMAP/POP 및 언어 설정을 포함한 설정 관리
• 사서함 변경 사항에 대한 기록 추적
• Google Cloud 자격 증명을 사용하여 보안 OAuth2 인증

설치

⚠️ 참고: 이 서버에서 사용할 수 있는 엔드포인트 수가 많으므로 클라이언트 애플리케이션에 노출되는 엔드포인트 수를 제한하기 위해 Heimdall을 설치하고 설정하는 것이 좋습니다.

이 MCP를 사용하려면 Gmail로 인증을 설정해야 합니다.

1. Google Cloud Console 로 이동
2. 새 프로젝트를 만들거나 기존 프로젝트를 선택하세요
3. 프로젝트에 Gmail API를 활성화하세요
4. 자격 증명으로 이동하여 OAuth 2.0 클라이언트 ID를 만듭니다.
   • 애플리케이션 유형으로 "데스크톱 앱"을 선택하세요( 경고 : 이 유형을 선택하지 않으면 서버가 JSON 파일에서 키를 구문 분석할 수 없습니다)
   • 클라이언트 자격 증명 JSON 파일을 다운로드하세요
5. 다운로드한 자격 증명 파일을 ~/.gmail-mcp/gcp-oauth.keys.json 에 저장합니다.

NPX (추천)

MCP 클라이언트 config.json 에 다음을 추가합니다(Heimdall을 사용하는 경우 ~/.heimdall/config.json ):

지엑스피1

수동 다운로드

1. 리포지토리 다운로드:

2. 패키지 설치 및 빌드(복제된 저장소 내부):

3. MCP 클라이언트 config.json 에 다음을 추가합니다(Heimdall을 사용하는 경우 ~/.heimdall/config.json ):

대장간

Smithery를 통해 Claude Desktop을 자동으로 설치하려면:

입증

자동화됨(권장)

이 MCP는 자동화된 인증 흐름을 제공합니다.

1. 먼저 OAuth 자격 증명을 얻고 JSON 파일을 다운로드합니다.
2. JSON 파일 이름을 gcp-oauth.keys.json 으로 바꾸고 $HOME/.gmail-mcp/ 또는 MCP_CONFIG_DIR 에 설정한 위치로 복사합니다.
3. 인증 명령을 실행합니다.

4. 브라우저 창이 자동으로 열리고 Google OAuth 동의 화면이 표시됩니다.
5. 접근 허용 후 브라우저 창을 닫아도 됩니다.
6. 토큰은 $HOME/.gmail-mcp/credentials.json 에 자동으로 저장됩니다.

MCP는 자동으로 다음을 수행합니다.

• 토큰 새로 고침 관리
• 자격 증명을 디스크에 저장
• OAuth 콜백 처리
• 기본 브라우저에서 인증 URL을 엽니다.

참고: 기본적으로 이 서버는 OAuth 응답을 수신하기 위해 포트 3000 사용합니다. 3000 에서 다른 서비스를 실행 중인 경우 AUTH_SERVER_PORT 다른 값으로 설정할 수 있습니다.

명령을 실행하기 전에 MCP_CONFIG_DIR 설정하여 구성 위치를 사용자 지정할 수 있습니다(선택 사항):

매뉴얼(Docker 사용에 권장)

원하는 경우 환경 변수를 통해 자격 증명을 직접 제공할 수도 있습니다.

지원되는 엔드포인트

사용자 관리

• get_profile : 현재 사용자의 Gmail 프로필을 가져옵니다.
• stop_mail_watch : 푸시 알림 수신 중지
• watch_mailbox : 메일함 변경 사항에 대한 푸시 알림 설정

메시지 관리

메시지 관리

• list_messages : 선택적 필터링을 사용하여 메시지 나열
• get_message : 특정 메시지를 가져옵니다
• get_attachment : 메시지 첨부 파일 가져오기
• modify_message : 메시지 라벨 수정
• send_message : 지정된 수신자에게 이메일 메시지를 보냅니다.
• delete_message : 메시지를 영구적으로 삭제합니다.
• trash_message : 메시지를 휴지통으로 이동
• untrash_message : 휴지통에서 메시지 제거
• batch_modify_messages : 여러 메시지 수정
• batch_delete_messages : 여러 개의 메시지 삭제

라벨 관리

• list_labels : 모든 라벨을 나열합니다
• get_label : 특정 라벨을 가져옵니다
• create_label : 새 라벨을 만듭니다
• update_label : 레이블 업데이트
• patch_label : 레이블의 부분 업데이트
• delete_label : 라벨 삭제

스레드 관리

• list_threads : 이메일 스레드 목록
• get_thread : 특정 스레드를 가져옵니다
• modify_thread : 스레드 라벨 수정
• trash_thread : 스레드를 휴지통으로 이동
• untrash_thread : 휴지통에서 스레드 제거
• delete_thread : 스레드 삭제

초안 관리

• list_drafts : 사용자 사서함의 초안을 나열합니다.
• get_draft : ID로 특정 초안 가져오기
• create_draft : Gmail에서 임시 이메일 만들기
• update_draft : 초안의 내용을 교체합니다.
• delete_draft : 초안 삭제
• send_draft : 기존 초안 보내기

설정 관리

자동 전달

• get_auto_forwarding : 자동 전달 설정 가져오기
• update_auto_forwarding : 자동 전달 설정 업데이트

IMAP 설정

• get_imap : IMAP 설정 가져오기
• update_imap : IMAP 설정 업데이트

POP 설정

• get_pop : POP 설정 가져오기
• update_pop : POP 설정 업데이트

휴가 응답자

• get_vacation : 휴가 응답 설정 가져오기
• update_vacation : 휴가 응답자 업데이트

언어 설정

• get_language : 언어 설정 가져오기
• update_language : 언어 설정 업데이트

대표단

• list_delegates : 계정 대리인 목록
• get_delegate : 특정 대리자를 가져옵니다
• add_delegate : 대리자 추가
• remove_delegate : 대리자 제거

필터

• list_filters : 이메일 필터 목록
• get_filter : 특정 필터를 가져옵니다
• create_filter : 새로운 필터를 생성합니다
• delete_filter : 필터 삭제

전달 주소

• list_forwarding_addresses : 전달 주소 나열
• get_forwarding_address : 특정 전달 주소를 가져옵니다
• create_forwarding_address : 전달 주소 생성
• delete_forwarding_address : 전달 주소 삭제

보내기 설정

• list_send_as : send-as 별칭 목록
• get_send_as : 특정 보내기 별칭을 가져옵니다.
• create_send_as : 보내기 별칭을 만듭니다.
• update_send_as : send-as 별칭 업데이트
• patch_send_as : send-as 별칭의 부분 업데이트
• verify_send_as : 인증 이메일 보내기
• delete_send_as : 보내기 별칭 삭제

S/MIME 설정

• list_smime_info : S/MIME 구성 목록
• get_smime_info : 특정 S/MIME 구성을 가져옵니다.
• insert_smime_info : 새로운 S/MIME 구성 업로드
• set_default_smime_info : 기본 S/MIME 구성 설정
• delete_smime_info : S/MIME 구성 삭제

기여하다

여러분의 참여를 환영하며 적극 권장합니다. 질문, 의견 또는 우려 사항이 있으시면 austin@shinzolabs.com 으로 연락해 주세요.