# Gmail Tool

> Gmail 연동 도구. 미읽음 확인·본문 읽기·임시보관 작성을 OAuth2 Gmail API로 수행한다. Use when: 받은편지함 확인, 본문 조회, 임시보관 작성, 라벨 메일 처리가 필요할 때.

- Skill: `xuiltul/gmail-tool-3` (Agent Skill)
- Install (CLI): `npx skillmds@latest add xuiltul/gmail-tool-3`
- Raw SKILL.md: https://api.skillmd.com/api/skills/xuiltul/gmail-tool-3/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: xuiltul (https://skillmd.com/u/xuiltul)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/xuiltul/gmail-tool-3

---


# Gmail 도구

Gmail을 OAuth2로 직접 조작하는 외부 도구입니다.

## 호출 방법

**Bash**: `animaworks-tool gmail <서브커맨드> [인수]`로 실행합니다.

## 액션 목록

### unread — 읽지 않은 메일 목록
```bash
animaworks-tool gmail unread [-n 20]
```

### read_body — 메일 본문 읽기
```bash
animaworks-tool gmail read MESSAGE_ID
```

### draft — 임시 보관함 작성
```bash
animaworks-tool gmail draft --to ADDR --subject SUBJ --body BODY [--thread-id TID]
```

## CLI 사용법

```bash
animaworks-tool gmail unread [-n 20]
animaworks-tool gmail read MESSAGE_ID
animaworks-tool gmail draft --to ADDR --subject SUBJ --body BODY [--thread-id TID]
```

## 주의사항

- 최초 사용 시 OAuth2 인증 흐름이 필요합니다
- credentials.json과 token.json이 ~/.animaworks/에 배치되어야 합니다