# GWS Gmail Examples & Reference

Load when working with Gmail.

## List Unread Messages

```bash
gws gmail users messages list --params '{"userId": "me", "q": "is:unread"}'
```

## Search with Filters

```bash
# From a specific sender in the last week
gws gmail users messages list --params '{"userId": "me", "q": "from:someone@example.com newer_than:7d"}'

# With attachment
gws gmail users messages list --params '{"userId": "me", "q": "has:attachment filename:pdf"}'

# Labeled messages
gws gmail users messages list --params '{"userId": "me", "q": "label:important"}'
```

## Read a Message

```bash
gws gmail users messages get --params '{"userId": "me", "id": "MESSAGE_ID"}'
```

## Read Message (minimal format, faster)

```bash
gws gmail users messages get --params '{"userId": "me", "id": "MESSAGE_ID", "format": "minimal"}'
```