# Google Gmail

> Read and send email via the Gmail API using curl + OAuth tokens.

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

---


# Google Gmail

Read and send email via Gmail API.

## Environment Variables

- `GOOGLE_ACCESS_TOKEN` - OAuth2 access token with `gmail` scope

## List recent messages

```bash
curl -s -H "Authorization: Bearer $GOOGLE_ACCESS_TOKEN" \
  "https://gmail.googleapis.com/gmail/v1/users/me/messages?maxResults=5" \
  | jq '.messages[].id'
```

## Read a message

```bash
curl -s -H "Authorization: Bearer $GOOGLE_ACCESS_TOKEN" \
  "https://gmail.googleapis.com/gmail/v1/users/me/messages/MSG_ID?format=full" \
  | jq '{subject: (.payload.headers[] | select(.name=="Subject") | .value), from: (.payload.headers[] | select(.name=="From") | .value), snippet}'
```

## Send a message

```bash
python3 -c "
import base64, json
raw = 'From: me\r\nTo: recipient@example.com\r\nSubject: Hello\r\n\r\nBody text here'
encoded = base64.urlsafe_b64encode(raw.encode()).decode()
print(json.dumps({'raw': encoded}))
" | curl -s -X POST \
  -H "Authorization: Bearer $GOOGLE_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d @- \
  "https://gmail.googleapis.com/gmail/v1/users/me/messages/send" \
  | jq '{id, threadId}'
```

## Search

```bash
curl -s -H "Authorization: Bearer $GOOGLE_ACCESS_TOKEN" \
  "https://gmail.googleapis.com/gmail/v1/users/me/messages?q=from:boss@example.com+is:unread&maxResults=5" \
  | jq '.messages[].id'
```

## Notes

- Always confirm recipient and content before sending.
- Token refresh is handled externally.