Gmail MCP

Gmail MCP

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

특징

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

필수 조건

이 MCP 서버를 실행하려면 먼저 조직에 대한 Google API 클라이언트를 설정하고 각 사용자가 스크립트를 실행하여 자신의 OAuth 새로 고침 토큰을 검색해야 합니다.

Google API 클라이언트 설정(조직당 한 번)

1. Google Cloud Console 로 이동합니다.
2. 새로운 프로젝트를 만들거나 기존 프로젝트를 선택하세요.
3. 프로젝트에 Gmail API를 활성화하세요.
4. 사용자 인증 정보로 이동하여 OAuth 2.0 클라이언트 ID를 생성하세요. 클라이언트 유형으로 "데스크톱 앱"을 선택하세요.
5. OAuth 키 JSON을 다운로드하여 ~/.gmail-mcp/gcp-oauth.keys.json 으로 저장합니다.
6. (선택 사항) 원격 서버 설치(예: Smithery CLI 사용)의 경우 이 파일의 CLIENT_ID 및 CLIENT_SECRET 기록해 둡니다.

클라이언트 OAuth(사용자당 한 번)

1. 사용자에게 ~/.gmail-mcp/gcp-oauth.keys.json 자신의 컴퓨터와 동일한 경로에 복사하도록 합니다.
2. npx @shinzolabs/gmail-mcp auth 실행합니다.
3. 사용자가 프로필을 선택하고, 요청된 범위를 검토하고, 승인할 수 있는 브라우저 창이 열립니다.
4. (선택 사항) 원격 서버 설치의 경우, 성공 메시지에 언급된 파일 경로(기본값 ~/.gmail-mcp/credentials.json )를 기록해 두세요. 사용자의 REFRESH_TOKEN 여기에 있습니다.

클라이언트 구성

MCP 클라이언트를 서버와 함께 구성하는 데에는 여러 가지 옵션이 있습니다. 호스팅/원격 서버 설정의 경우 Smithery API 키 와 함께 Smithery CLI를 사용하세요. 로컬 설치의 경우 npx 사용하거나 소스에서 빌드하세요. 각 옵션에 대한 설명은 아래에서 확인할 수 있습니다.

Smithery 원격 서버(추천)

MCP 클라이언트 config.json 에 원격 서버를 추가하려면 Smithery CLI 에서 다음 명령을 실행하세요.

지엑스피1

메시지가 표시되면 CLIENT_ID , CLIENT_SECRET , REFRESH_TOKEN 입력하세요.

스미서리 SDK

자체 에이전트 애플리케이션을 개발하는 경우 여기의 보일러플레이트 코드를 사용할 수 있습니다.

NPX 로컬 설치

npx 를 사용하여 로컬로 서버를 설치하려면 MCP 클라이언트 config.json 에 다음을 추가하세요.

소스에서 빌드

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

2. 패키지를 설치하고 pnpm 으로 빌드합니다(복제된 저장소 내부):

3. MCP 클라이언트 config.json 에 다음을 추가하세요.

구성 변수

지원되는 엔드포인트

사용자 관리

• 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 구성 삭제

기여하다

여러분의 참여를 환영하며 적극 권장합니다! 이슈, 참여 방법, 연락처 정보는 CONTRIBUTING.md에서 확인하세요.