Gmail MCP 서버

Claude Desktop과 같은 MCP 클라이언트에 Gmail 통합 기능을 제공하는 MCP(Model Context Protocol) 서버입니다.

특징

• Gmail 받은 편지함에서 최근 이메일 보기
• Gmail의 검색 구문을 사용하여 이메일 검색
• Gmail API를 사용한 안전한 OAuth2 인증

설정

1. Google Cloud 프로젝트 설정

1. https://console.cloud.google.com/ 에서 Google Cloud 프로젝트를 만드세요.
2. Gmail API 활성화
3. OAuth 2.0 자격 증명을 만듭니다.
   • 응용 프로그램 유형: 데스크톱 응용 프로그램
   • 자격 증명을 credentials.json 으로 다운로드합니다.

2. 설치

지엑스피1

3. Claude Desktop 구성

claude_desktop_config.json 에 다음을 추가하세요:

/path/to/ 실제 경로로 바꾸세요. 토큰 파일은 처음 인증할 때 자동으로 생성됩니다.

4. 첫 번째 실행

Claude를 통해 Gmail에 처음 접속하려고 하면 브라우저에서 애플리케이션을 승인하라는 메시지가 표시됩니다. 승인 후, 사용자 인증 정보는 나중에 사용할 수 있도록 토큰 파일에 저장됩니다.

사용 가능한 리소스

• gmail://inbox/recent - 가장 최근의 이메일 10개를 반환합니다.

사용 가능한 도구

• search_emails
  • 설명: 쿼리로 Gmail 이메일 검색
  • 매개변수:
    • query (필수): Gmail 검색어(Gmail의 표준 검색 구문 사용)
    • max_results (선택 사항): 반환할 최대 결과 수(기본값: 10)

검색 예시:

보안

이 서버에는 Gmail을 통한 OAuth2 인증이 필요합니다.

• 처음 사용할 때 브라우저에서 액세스를 승인하라는 메시지가 표시됩니다.
• 자격 증명은 지정된 토큰 파일에 로컬로 저장됩니다.
• Google 계정 설정을 통해 언제든지 액세스를 취소할 수 있습니다.
• Gmail에 대한 읽기 권한만 요청됩니다(쓰기 권한은 없음)

환경 변수

• GMAIL_CREDENTIALS_FILE (필수): Google OAuth 자격 증명 파일의 경로
• GMAIL_TOKEN_FILE (필수): 인증 토큰이 저장될 경로

테스트를 위해 서버를 직접 실행할 수 있습니다.

개발

서버는 모델 컨텍스트 프로토콜을 사용하여 다음을 제공합니다.

• 최근 이메일에 대한 리소스 액세스
• 이메일 검색을 위한 도구 지원
• 보안 OAuth2 인증 흐름
• 자동 토큰 새로 고침

벌채 반출

서버는 다음을 포함하여 작업에 대한 자세한 정보를 stderr에 기록합니다.

• 서버 시작 정보
• 인증 상태
• 리소스 및 도구 사용
• 오류나 문제가 있으면

기여하다

풀 리퀘스트를 환영합니다! 다음 사항을 확인해 주세요.

• 새로운 기능에 대한 설명서를 업데이트합니다.
• 적절한 오류 처리 추가
• 새로운 기능으로 OAuth 흐름 테스트
• 기존 코드 스타일을 따르세요