> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fliiq.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Gmail Assistant

> Full inbox management — triage, respond, archive, delete across multiple accounts

Fliiq as your personal Gmail assistant. Read your inbox, respond to important emails, archive newsletters, delete spam — all from a single conversation or automated job.

<Note>
  This example uses Fliiq's [Google OAuth integration](/guides/google) to access **your** Gmail accounts. Make sure you've run `fliiq google auth` and authorized at least one account before trying this.
</Note>

## Interactive Usage

### Inbox Triage

```
You: Check my personal email for unread messages

Fliiq: Found 14 unread emails on andy@gmail.com:

  1. Alice Chen (Re: Dinner Saturday) — "7pm works! Should I bring anything?"
  2. GitHub (Security Alert) — Dependabot detected 2 vulnerabilities in fliiq/fliiq
  3. Booking.com (Trip Confirmation) — Hotel reservation confirmed for Mar 15-18
  4. Newsletter: TechCrunch Daily — "AI agents are eating the world..."
  5. James Wu (Contract Review) — "Attached the redlines, need signature by Friday"
  6. Spotify (Your Weekly Mix) — "Your Discover Weekly is ready"
  ...and 8 more

  3 look important (Alice, GitHub alert, James). 6 are newsletters. 5 are promotions.
  Want me to handle any of these?
```

### Responding to Emails

```
You: Reply to Alice and say 7pm is great, just bring yourself. Archive the newsletters and delete the promotions.

Fliiq: Done:
  ✓ Sent reply to Alice Chen from andy@gmail.com
  ✓ Archived 6 newsletters
  ✓ Deleted 5 promotions
  ✓ Marked all processed emails as read

  Left in inbox: GitHub security alert, James Wu's contract, Booking.com confirmation.
```

### Multi-Account

```
You: Now check my work email too

Fliiq: Found 8 unread emails on andy@company.com:

  1. Sarah (Standup Notes) — Action items from today's standup
  2. Jira (PROJ-442 assigned) — "Refactor auth middleware" assigned to you
  3. HR (Benefits Enrollment) — Open enrollment ends Feb 28
  4. DevOps Bot (Deploy Alert) — Production deploy v2.4.1 succeeded
  ...and 4 more

  Want me to handle any of these?
```

### Full Inbox Cleanup

```
You: Do a full cleanup on both accounts — archive anything that's informational,
     delete obvious spam, and leave anything that needs my attention

Fliiq: Cleaned up both inboxes:

  andy@gmail.com:
    ✓ Archived 3 (GitHub alert — no action needed, Booking confirmation, Spotify)
    ✓ Deleted 0
    ✗ Left 1: James Wu's contract — needs your signature by Friday

  andy@company.com:
    ✓ Archived 5 (standup notes, Jira notification, deploy alert, 2 FYIs)
    ✓ Deleted 1 (spam)
    ✗ Left 2: HR benefits enrollment (deadline Feb 28), client meeting request

  Total: 8 archived, 1 deleted, 3 need your attention.
```

## Automated Inbox Cleanup Job

Set up a scheduled job that keeps your inbox clean daily:

```yaml theme={null}
name: inbox-cleanup
trigger:
  type: cron
  schedule: "0 7 * * *"       # 7am daily
prompt: |
  Check my personal email (andy@gmail.com) and work email (andy@company.com)
  for unread messages.

  For each email:
  - If it's a newsletter, marketing, or automated notification: archive it
  - If it's spam or irrelevant: delete it
  - If it needs my attention: leave it and include it in the summary

  Read your job memory to see what you processed yesterday to avoid duplicates.
  Update your memory with today's processed message IDs.

  Deliver a summary of what you did and what's still waiting for me.
skills:
  - receive_emails
  - mark_email_read
  - archive_email
  - delete_email
  - memory_read
  - memory_write
delivery:
  type: email
  to: andy@gmail.com
enabled: true
```

## Sample Job Output

```
Daily Inbox Cleanup — Feb 14, 2026

Personal (andy@gmail.com):
  Archived: 4 (2 newsletters, Spotify weekly, shipping notification)
  Deleted: 1 (spam)
  Needs attention:
    - James Wu (Contract Review) — Needs signature by Friday
    - Mom (Weekend Plans) — Asking about Sunday brunch

Work (andy@company.com):
  Archived: 6 (3 Jira notifications, deploy alert, 2 FYI threads)
  Deleted: 0
  Needs attention:
    - Sarah (Q1 Planning) — Asking for your availability next week
    - HR (Benefits) — Open enrollment deadline Feb 28

Summary: 10 archived, 1 deleted, 4 need your attention.
```

## Try It Yourself

```bash theme={null}
# Authorize your Gmail accounts
fliiq google auth

# Interactive inbox check
fliiq run "Check my email for unread messages and summarize them"

# Full cleanup
fliiq run "Clean up my inbox — archive newsletters, delete spam, summarize what's left"

# Respond to a specific email
fliiq run "Reply to the last email from Alice saying I'll be there at 7"
```