@kazuph/mcp-gmail-gas

MCP 지메일

Gmail 통합을 위한 모델 컨텍스트 프로토콜 서버입니다. 이를 통해 Claude Desktop(또는 모든 MCP 클라이언트)이 Google Apps Script를 통해 Gmail 계정과 상호 작용할 수 있습니다.

빠른 시작(사용자용)

필수 조건

• Node.js 18+ ( brew install node 통해 설치)
• Gmail 계정
• Google Apps Script 배포
• Claude Desktop( https://claude.ai/desktop 에서 설치)

구성

1. Google Apps Script 배포

• Google Apps Script를 방문하여 새 프로젝트를 만드세요.
• code.gs 의 전체 내용을 복사하여 스크립트 편집기에 붙여넣습니다.
• "배포" > "새 배포"를 클릭하세요.
• 배포 유형으로 "웹 앱"을 선택하세요
• 다음 설정을 구성하세요.
  • 실행자: 나
  • 접근 권한이 있는 사람: 누구나
  • "배포"를 클릭하세요
• 메시지가 표시되면 앱을 검토하고 Gmail 계정에 액세스할 수 있도록 승인하세요.
• 배포 URL을 복사하고 보안을 위해 무작위 API 키를 생성합니다.

참고: 이 스크립트에는 Gmail 액세스 권한이 필요합니다. 스크립트를 처음 배포하고 실행할 때 Google에서 이러한 권한을 검토하고 부여해 달라고 요청합니다. 다음 사항을 확인하세요.

1. "권한 검토"를 클릭하세요
2. Google 계정을 선택하세요
3. 경고가 표시되면 "고급"을 클릭하세요.
4. "[프로젝트 이름]으로 이동(안전하지 않음)"을 클릭하세요.
5. "허용"을 클릭하여 필요한 Gmail 권한을 부여하세요.
6. ~/Library/Application Support/Claude/claude_desktop_config.json 에서 Claude Desktop 구성 파일을 엽니다.

Claude Desktop 메뉴를 통해 이 기능을 찾을 수 있습니다.

1. 클로드 데스크톱 열기
2. Mac 메뉴 막대에서 Claude를 클릭하세요
3. "설정"을 클릭하세요
4. "개발자"를 클릭하세요
5. 구성에 다음을 추가하세요.

지엑스피1

참고: YOUR_DEPLOYMENT_URL 과 YOUR_API_KEY 실제 값으로 바꾸세요.

개발자를 위한

필수 조건

• Node.js 18+ ( brew install node 통해 설치)
• Gmail 계정
• 구글 앱 스크립트
• Claude Desktop( https://claude.ai/desktop 에서 설치)
• tsx ( npm install -g tsx 를 통해 설치)

설치

개발 구성

1. Claude Desktop이 설치되어 실행 중인지 확인하세요.
2. 아직 설치하지 않았다면 tsx를 전역적으로 설치하세요.

3. ~/Library/Application Support/Claude/claude_desktop_config.json 에 있는 Claude Desktop 구성을 수정하세요.

MCP 클라이언트 구성에 다음을 추가하세요.

사용 가능한 도구

• gmail_search_messages : Gmail 검색 쿼리 구문을 사용하여 이메일을 검색합니다(예: "subject newer_than:1d").
• gmail_get_message : 특정 이메일의 전체 내용과 세부 정보를 가져옵니다.
• gmail_download_attachment : 특정 이메일에서 첨부 파일을 다운로드합니다.

보안 참고 사항

VALID_API_KEY 는 항상 비밀로 유지하고 버전 관리 시스템에 절대 공개하지 마세요. 이 키는 권한이 있는 클라이언트만 Google Apps Script 배포를 통해 Gmail에 액세스할 수 있도록 하는 데 도움이 됩니다.