Gmail MCP Server

Gmail MCP 서버

Claude AI가 Gmail과 직접 상호 작용할 수 있도록 하는 강력한 MCP(Model Context Protocol) 서버입니다.

📖 목차

• 개요
• 주요 특징
• 빠른 시작
  • 필수 조건
  • 설치
  • Google Cloud 및 OAuth 자격 증명 설정
  • 첫 번째 실행 및 인증
  • Claude Desktop 구성
• 사용 가능한 도구
• 사용 예
• 고급 구성
  • 환경 변수
  • SSE 서버 모드
• 선적 서류 비치
• 보안 고려 사항
• 기여하다
• 특허
• 감사의 말

📋 개요

Gmail MCP 서버는 클로드와 같은 AI 비서가 자연어를 통해 Gmail과 직접 상호작용할 수 있도록 하는 포괄적인 구현입니다. 이메일 관리를 위한 다양한 도구를 제공하여 대화형 AI와 받은편지함 간의 원활한 통합을 지원합니다.

💡 주요 특징

• 완벽한 이메일 관리
  • 첨부 파일이 포함된 일반 텍스트 및 HTML 이메일 보내기
  • 복잡한 메시지 구조를 적절히 분석하여 이메일을 읽습니다.
  • Gmail의 강력한 쿼리 구문으로 받은 편지함을 검색하세요
  • 초안 이메일 만들기 및 업데이트
  • 라벨, 읽음/읽지 않음 상태 및 휴지통 관리
  • 여러 이메일에 대한 일괄 작업 수행
• 고급 통합
  • async/await 패턴을 적용한 최신 Python 코드베이스
  • 포괄적인 오류 처리 및 복구
  • 자세한 진행 상황 보고
  • 보안 OAuth 인증 흐름
  • 다양한 전송 모드(STDIO 및 SSE)
  • 다양한 배포 시나리오 지원

🚀 빠른 시작

필수 조건

• Python 3.8 이상
• Gmail API가 활성화된 Google Cloud 프로젝트
• Gmail API에 대한 OAuth 2.0 자격 증명

설치

1. 저장소를 복제합니다지엑스피1
2. 가상 환경 설정
   python -m venv venv # On Windows venv\Scripts\activate # On macOS/Linux source venv/bin/activate
3. 종속성 설치
   pip install -r requirements.txt
4. Google Cloud 및 OAuth 자격 증명 설정Google Cloud Console을 방문하여 다음을 확인하세요.
   • 새 프로젝트를 만듭니다
   • Gmail API 활성화
   • OAuth 동의 화면 설정
   • OAuth 클라이언트 ID 자격 증명 만들기(데스크톱 애플리케이션)
   • 프로젝트 루트에 credentials.json 으로 자격 증명을 다운로드합니다.

첫 번째 실행 및 인증

서버를 한 번 실행하여 인증합니다.

Google 계정으로 인증하라는 브라우저 창이 열립니다. 인증 후 token.json 파일이 생성되어 나중에 사용할 수 있도록 저장됩니다.

Claude Desktop 구성

1. Claude Desktop 구성 파일을 편집하세요.
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
2. 구성에 Gmail MCP 서버를 추가합니다.
   { "mcpServers": { "gmail": { "command": "python", "args": [ "/absolute/path/to/gmail-mcp-server/gmail_server.py" ] } } }
3. 파일을 저장하고 Claude Desktop을 다시 시작하세요.

참고: "/absolute/path/to/gmail-mcp-server/gmail_server.py" 복제된 저장소의 gmail_server.py 파일에 대한 실제 절대 경로로 바꾸세요.

🧰 사용 가능한 도구

Gmail MCP 서버는 Claude에게 다음 도구를 제공합니다.

이메일 전송

• send_email - 텍스트/HTML 콘텐츠로 기본 이메일 보내기
• send_email_with_attachment - 첨부 파일이 있는 이메일 보내기
• send_email_with_multiple_attachments - 여러 개의 첨부 파일이 포함된 이메일 보내기

이메일 읽기

• read_email - ID로 특정 이메일의 내용을 읽습니다.
• get_unread_emails - 읽지 않은 이메일 목록 가져오기
• get_important_emails - 이메일을 중요한 것으로 표시
• get_emails_with_attachments - 첨부 파일이 있는 이메일 받기
• get_recent_emails - 지난 X일간의 이메일 가져오기

이메일 검색 및 구성

• search_emails - Gmail의 쿼리 구문을 사용하여 이메일 검색
• get_email_labels - 모든 Gmail 라벨/폴더 나열
• create_email_label - 새 라벨을 만듭니다
• delete_email_label - 기존 라벨 삭제
• label_email - 이메일에 라벨을 적용합니다
• remove_email_label - 이메일에서 라벨 제거

이메일 상태 관리

• mark_as_read - 이메일을 읽음으로 표시
• mark_as_unread - 이메일을 읽지 않음으로 표시
• delete_email - 이메일을 휴지통으로 이동

초안 관리

• create_email_draft - 새 임시 이메일 만들기
• update_email_draft - 기존 초안 업데이트
• list_email_drafts - 사용 가능한 초안 목록
• send_draft - 기존 초안 보내기

배치 작업

• batch_apply_label - 여러 이메일에 라벨을 적용합니다.
• batch_delete_emails - 여러 이메일을 휴지통으로 이동

계정 정보

• get_email_profile - Gmail 프로필 정보 가져오기
• summarize_recent_emails - 최근 이메일 요약을 만듭니다.

💬 사용 예시

클로드에 대한 몇 가지 예시 프롬프트는 다음과 같습니다.

🔧 고급 구성

환경 변수

서버는 사용자 정의를 위해 여러 환경 변수를 지원합니다.

SSE 서버 모드

HTTP 기반 통합을 위해 서버는 SSE(Server-Sent Events) 모드로 실행될 수 있습니다.

이렇게 하면 지정된 포트(기본값: 3000)에서 서버가 시작되어 HTTP를 통해 접근할 수 있습니다.

📚 문서

• MCP 사양 - 모델 컨텍스트 프로토콜에 대해 알아보세요
• Gmail API 문서 - Gmail API 기능에 대한 참조
• Google Cloud OAuth - 인증 흐름에 대한 세부 정보

🔒 보안 고려 사항

• 서버는 안전한 Gmail API 인증을 위해 OAuth 2.0을 사용합니다.
• 모든 작업은 로컬 컴퓨터에서 실행됩니다. 이메일은 타사 서버를 거치지 않습니다.
• 인증 토큰은 로컬에 저장되며 언제든지 취소할 수 있습니다.
• 서버는 첨부 파일을 읽기 위해서만 로컬 파일 액세스가 필요합니다.
• Claude는 이메일을 보내거나 삭제하기 전에 항상 확인을 요청합니다.

🤝 기여하기

기여를 환영합니다! 풀 리퀘스트를 제출해 주세요.

1. 저장소를 포크하세요
2. 기능 브랜치를 생성합니다( git checkout -b feature/amazing-feature )
3. 변경 사항을 커밋하세요( git commit -m 'Add some amazing feature' )
4. 브랜치에 푸시( git push origin feature/amazing-feature )
5. 풀 리퀘스트 열기

📝 라이센스

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.

🙏 감사의 말

• Gmail API를 위한 Google
• Claude와 모델 컨텍스트 프로토콜을 위한 인류학적
• Python Gmail API 클라이언트 라이브러리에 기여한 사람들