Community코딩 & 개발github.com

googleworkspace/gws-gmail-read

Gmail: 메시지를 읽고 본문이나 헤더를 추출합니다.

gws-gmail-read란 무엇인가요?

이 스킬은 Google Workspace Gmail API를 통해 지정된 Gmail 메시지의 본문이나 헤더를 읽고 추출하는 기능을 제공합니다. 개발자나 AI 에이전트가 특정 메시지 ID를 기반으로 이메일의 전체 내용(텍스트/HTML 본문) 또는 특정 헤더(예: 제목, 발신자, 수신자, 날짜 등)를 손쉽게 가져올 수 있도록 설계되었습니다. 주로 Claude Code, Cursor, Codex와 같은 AI 코딩 어시스턴트 환경에서 메일 자동 처리, 정보 수집, 또는 워크플로우 자동화에 활용됩니다. 이 스킬을 사용하면 수동으로 이메일을 확인할 필요 없이 AI가 직접 메일의 핵심 데이터를 추출하여 후속 작업(예: 요약, 알림, 데이터 입력)에 연계할 수 있어 생산성이 크게 향상됩니다. Google Workspace와의 OAuth 인증을 필요로 하며, 안전하게 메시지 데이터를 읽어옵니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/googleworkspace/cli/tree/main/skills/gws-gmail-read

Installed? Explore more 코딩 & 개발 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

gws-gmail-read은(는) 무엇을 하나요?

Gmail: 메시지를 읽고 본문이나 헤더를 추출합니다.

개요

이 스킬은 Google Gmail API를 사용하여 지정된 Gmail 메시지의 세부 정보를 가져옵니다. 메시지 본문(텍스트 또는 HTML 형식)과 특정 헤더(예: 제목, 발신자, 수신자 등)를 추출할 수 있습니다.

사용 예시

- 메시지 ID를 기준으로 이메일 본문 읽기
- 특정 발신자의 이메일 헤더 정보 추출
- 수신된 이메일의 내용을 AI로 요약하기 위한 데이터 수집

요구 사항

  • 유효한 Google Workspace 계정
  • Gmail API 사용 설정 및 OAuth 2.0 인증
  • 대상 Gmail 메시지에 대한 읽기 권한

환경 변수

  • GOOGLE_APPLICATION_CREDENTIALS: Google 서비스 계정 키 파일의 경로
  • 또는 OAuth 클라이언트 ID/시크릿을 통한 사용자 인증

관련 스킬

  • googleworkspace/gws-gmail-send: Gmail 메시지 보내기
  • googleworkspace/gws-gmail-list: Gmail 메시지 목록 보기

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

googleworkspace/gws-admin-reports

Google Workspace Admin SDK: Audit logs and usage reports.

googleworkspace/gws-calendar

Google Calendar: Manage calendars and events.

googleworkspace/gws-calendar-agenda

Google Calendar: Show upcoming events across all calendars.

googleworkspace/gws-calendar-insert

Google Calendar: Create a new event.

googleworkspace/gws-chat

Google Chat: Manage Chat spaces and messages.

googleworkspace/gws-chat-send

Google Chat: Send a message to a space.

googleworkspace/gws-classroom

Google Classroom: Manage classes, rosters, and coursework.

googleworkspace/gws-docs

Read and write Google Docs.

googleworkspace/gws-docs-write

Google Docs: Append text to a document.

googleworkspace/gws-drive

Google Drive: Manage files, folders, and shared drives.

googleworkspace/gws-drive-upload

Google Drive: Upload a file with automatic metadata.

googleworkspace/gws-events

Subscribe to Google Workspace events.

googleworkspace/gws-events-renew

Google Workspace Events: Renew/reactivate Workspace Events subscriptions.

googleworkspace/gws-events-subscribe

Google Workspace Events: Subscribe to Workspace events and stream them as NDJSON.

googleworkspace/gws-forms

Read and write Google Forms.

googleworkspace/gws-gmail

Gmail: Send, read, and manage email.

googleworkspace/gws-gmail-forward

Gmail: Forward a message to new recipients.

googleworkspace/gws-gmail-reply

Gmail: Reply to a message (handles threading automatically).

googleworkspace/gws-gmail-reply-all

Gmail: Reply-all to a message (handles threading automatically).

googleworkspace/gws-gmail-send

Gmail: Send an email.

관련 스킬