모델 컨텍스트 프로토콜(MCP)을 위한 Gmail 서버

이 MCP 서버는 Gmail과 통합되어 이메일을 보내고, 삭제하고, 읽고, 초안을 작성하고, 답장할 수 있습니다.

참고: 이 서버를 통해 MCP 클라이언트는 이메일을 읽고, 삭제하고, 보낼 수 있습니다. 단, 클라이언트는 이러한 작업을 수행하기 전에 사용자에게 확인 메시지를 표시합니다.

https://github.com/user-attachments/assets/5794cd16-00d2-45a2-884a-8ba0c3a90c90

구성 요소

도구

• 이메일 보내기
  • 이메일 주소 수신자에게 이메일을 보냅니다.
  • 입력:
    • recipient_id (문자열): 수신자의 이메일 주소
    • subject (문자열): 이메일 제목
    • message (문자열): 이메일 내용
  • 상태 및 message_id를 반환합니다.
• 휴지통 이메일
  • 이메일을 휴지통으로 이동합니다
  • 입력:
    • email_id (문자열): 이메일의 자동 생성 ID
  • 성공 메시지를 반환합니다.
• 이메일을 읽음으로 표시
  • 이메일을 읽음으로 표시
  • 입력:
    • email_id (문자열): 이메일의 자동 생성 ID
  • 성공 메시지를 반환합니다.
• 읽지 않은 이메일 가져오기
  • 읽지 않은 이메일을 검색합니다
  • 이메일 ID를 포함한 이메일 목록을 반환합니다.
• 이메일 읽기
  • 주어진 이메일 내용을 검색합니다
  • 입력:
    • email_id (문자열): 이메일의 자동 생성 ID
  • 이메일 메타데이터 사전을 반환하고 이메일을 읽음으로 표시합니다.
• 오픈 이메일
  • 브라우저에서 이메일 열기
  • 입력:
    • email_id (문자열): 이메일의 자동 생성 ID
  • 성공 메시지를 반환하고 기본 브라우저에서 제공된 이메일을 엽니다.

설정

Gmail API 설정

1. 새로운 Google Cloud 프로젝트를 만듭니다.
2. Gmail API 활성화
3. OAuth 동의 화면 구성
   • "외부"를 선택하세요. 하지만 앱은 게시되지 않습니다.
   • "테스트 사용자"로 개인 이메일 주소를 추가하세요.
4. OAuth 범위 추가 https://www.googleapis.com/auth/gmail/modify
5. "데스크톱 앱" 애플리케이션 유형에 대한 OAuth 클라이언트 ID를 만듭니다.
6. 클라이언트의 OAuth 키 JSON 파일을 다운로드하세요.
7. 키 파일의 이름을 변경하고 로컬 컴퓨터의 안전한 위치에 저장하세요. 저장 위치를 기록해 두세요.
   • 서버가 시작되면 이 파일의 절대 경로가 --creds-file-path 매개변수로 전달됩니다.

입증

서버가 시작되면 시스템 브라우저에서 인증 흐름이 시작됩니다. 토큰 자격 증명은 --token-path 매개변수에 전달된 절대 파일 경로에 저장되고 나중에 검색됩니다.

예를 들어, [your-home-folder] .를 대체하여 홈 폴더에 도트 디렉토리를 사용할 수 있습니다.

데스크톱 앱 사용

uv를 사용하는 것이 좋습니다.

이 서버를 MCP 클라이언트로 Claude Desktop과 통합하려면 앱의 서버 구성에 다음을 추가하세요. 기본적으로 이 설정은 ~/Library/Application\ Support/Claude/claude_desktop_config.json 에 저장됩니다.

지엑스피1

다음 매개변수를 설정해야 합니다.

MCP Inspector를 사용한 문제 해결

서버를 테스트하려면 MCP Inspector를 사용하세요. git 저장소에서 아래 명령어를 실행하여 매개변수 인수를 적절히 변경하세요.