향상된 Gmail MCP 서버

Gmail 통합을 위한 강력하고 풍부한 기능을 갖춘 모델 컨텍스트 프로토콜(MCP) 서버로, Python으로 작성되었습니다. 이 서버는 Claude와 같은 AI 비서가 자연어를 통해 Gmail과 상호 작용할 수 있도록 지원하여 포괄적인 이메일 관리 기능을 제공합니다.

🌟 주요 특징

📧 완벽한 이메일 관리

사용자 정의 가능한 제목, 내용 및 수신자를 사용하여 이메일을 보내세요
전체 메타데이터로 이메일 콘텐츠를 읽고 검색합니다.
확인과 함께 이메일을 휴지통으로 이동
이메일을 읽음/읽지 않음으로 표시
브라우저에서 직접 이메일 열기

📝 초안 관리

나중에 검토할 수 있도록 초안 이메일을 작성하세요
모든 초안 이메일 나열
기존 초안 편집

🏷️ 고급 라벨 관리

사용 가능한 모든 라벨을 나열하세요
사용자 정의 라벨 만들기
이메일에 라벨 적용/제거
기존 라벨 이름 바꾸기
사용하지 않는 라벨 삭제
라벨로 이메일 검색

📁 폴더 구성

새 폴더 만들기(Gmail 라벨로 구현됨)
폴더 간에 이메일 이동
사용 가능한 모든 폴더 나열

🔍 강력한 검색 및 필터링

Gmail의 고급 쿼리 구문을 사용하여 이메일 검색
이메일 필터를 만들고, 관리하고, 삭제합니다.
보낸 사람, 받는 사람, 제목, 내용 등으로 필터링
유연한 매개변수로 검색 결과를 사용자 정의하세요

🗄️ 아카이브 관리

이메일 보관(삭제하지 않고 받은 편지함에서 제거)
검색 기준과 일치하는 여러 이메일을 일괄 보관합니다.
보관된 모든 이메일 나열
보관된 이메일을 받은 편지함으로 복원

🚀 시작하기

필수 조건

파이썬 3.8 이상
Gmail API가 활성화된 Google Cloud 프로젝트
OAuth 2.0 자격 증명

설치

지엑스피1

Google 클라우드 설정

새로운 Google Cloud 프로젝트를 만듭니다.
Gmail API 활성화
OAuth 동의 화면 구성:
- "외부" 사용자 유형을 선택하세요
- 테스트 사용자로 이메일을 추가하세요
- 범위 추가: https://www.googleapis.com/auth/gmail/modify
OAuth 2.0 자격 증명을 만듭니다.
- 애플리케이션 유형으로 "데스크톱 앱"을 선택하세요
- JSON 자격 증명 파일을 다운로드하세요

구성

서버를 실행할 때 자격 증명을 안전하게 저장하고 해당 위치를 지정하세요.

# Example directory structure for credentials
mkdir -p ~/.gmail-mcp
# Move your downloaded credentials file
mv ~/Downloads/client_secret_*.json ~/.gmail-mcp/credentials.json

🔧 사용법

Claude Desktop으로 실행

Claude Desktop 구성 파일(일반적으로 ~/Library/Application Support/Claude/claude_desktop_config.json )에 다음을 추가합니다.

{
  "mcpServers": {
    "gmail": {
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/to/gmail-mcp",
        "run",
        "gmail",
        "--creds-file-path",
        "/absolute/path/to/credentials.json",
        "--token-path",
        "/absolute/path/to/tokens.json"
      ]
    }
  }
}

MCP Inspector로 테스트

테스트 및 디버깅을 위해 MCP Inspector를 사용하세요.

npx @modelcontextprotocol/inspector uv run /path/to/gmail-mcp/src/gmail/server.py --creds-file-path /path/to/credentials.json --token-path /path/to/tokens.json

🔐 보안 고려 사항

자격 증명이나 토큰 파일을 버전 제어에 커밋하지 마십시오.
적절한 권한이 있는 안전한 위치에 자격 증명을 저장하세요.
서버는 민감한 작업을 수행하기 전에 사용자 확인을 요청합니다.
비정상적인 활동이 있는지 Google Cloud Console을 정기적으로 검토하세요.
민감한 경로에 환경 변수 사용을 고려하세요

🛠️ 건축

이 구현은 Google API 클라이언트 라이브러리를 통해 모든 Gmail 작업을 처리하는 포괄적인 단일 파일 아키텍처를 특징으로 합니다. 주요 구성 요소는 다음과 같습니다.

자동 토큰 새로 고침을 통한 OAuth2 인증
포괄적인 오류 처리 및 로깅
명확한 입력 스키마를 갖춘 구조화된 도구 정의
효율적인 이메일 구문 분석 및 서식 지정

📚 예시 프롬프트

Gmail MCP 서버를 연결한 후 Claude에게 다음 메시지를 시도해 보세요.

"읽지 않은 이메일 보여줘"
"첨부 파일이 있는 example@domain.com 에서 온 이메일 검색"
"중요 프로젝트"라는 새 라벨을 만듭니다.
" john@example.com 으로 다가오는 회의에 대한 이메일을 작성하세요"
" newsletter@example.com 에서 온 모든 이메일을 보관합니다."
"내 팀의 이메일에 자동으로 레이블을 지정하는 필터를 만듭니다."

🤝 기여하기

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

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

📄 라이센스

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

🙏 감사의 말

커뮤니티의 다양한 MCP 서버 구현에서 영감을 얻었습니다.
모델 컨텍스트 프로토콜 프레임워크로 구축됨
Google의 공식 API 클라이언트 라이브러리를 사용합니다.

Enhanced Gmail MCP Server

Integrations