Setup Guide

What does “read-only access” mean?

The plugin requests read-only permission to your Gmail account. This is the minimum access level needed for the plugin to work. Here’s exactly what it can and can’t do:

What it can see

• Your unread count per label (e.g. “3 unread in Inbox”)
• Sender names and subject lines (to display on your Stream Deck keys)
• Email body text (for the Latest Email Reader LCD action on devices with a screen)
• Your Gmail labels (so you can choose which label to monitor)

What it cannot do

• Send, delete, or modify any emails
• Access your contacts, calendar, or other Google services
• Store or transmit any data — everything stays on your device

Why does Google say it can “read” my emails?

Google uses broad permission descriptions. “Read” in this context means the plugin can retrieve information to display it — the same way your phone’s Gmail app retrieves emails to show them on screen. The plugin needs to see sender names, subjects, and content so it can show them on your Stream Deck. It does not “read” your emails in the sense that anyone at FlowKits sees them — we can’t and we don’t.

Monitoring

Live-updating keys that keep you informed without checking your phone or switching windows.

Inbox Monitor

Live unread email count on your Stream Deck key.

• Press � Opens your inbox in Gmail. If there’s exactly one unread email, it opens that email directly.
• Label � Monitor any label: Inbox, Starred, Important, or custom labels.
• Sound � Optional notification when new emails arrive, with 8 sound styles to choose from.
• Customize � 16 theme presets, icon styles, badge colors, and display labels.

Email Preview

Shows your latest email’s sender, subject, and body snippet on the key.

• Short Press � Toggle show/hide for privacy.
• Long Press � Open the email directly in Gmail.
• Customize � Background and text colors.

Sender Monitor

Tracks unread emails from a specific sender.

• Press � Search Gmail for emails from this sender.
• Display Label � Show the sender’s name on the key.
• Sound � Optional notification when new emails arrive from them.
• Customize � 16 theme presets, icon styles, badge colors, and display labels.

Search Monitor

Monitors any Gmail search query in real time.

• Press � Open the matching search results in Gmail.
• Query Builder � Visual query builder for complex searches � no need to memorize Gmail syntax.
• Sound � Optional notification when new matches are found.
• Customize � 16 theme presets, icon styles, badge colors, and display labels.

Quick Actions

One-press shortcuts to common Gmail actions.

Open Label

One-press access to any Gmail label or folder.

• Press � Opens the selected label in your browser.
• Display Label � Show the label name on the key for quick identification.

Compose

Instantly open a new email compose window.

• Press � Opens Gmail compose in your browser.

Google Calendar

Quick access to Google Calendar.

• Press � Opens Google Calendar in your browser.

Google Meet

Quick access to Google Meet.

• Press � Opens Google Meet in your browser.

LCD Screen

Rich email previews on your Stream Deck’s touchscreen. Rotate, press, and tap to interact.

Latest Email Reader

Read your latest email directly on the LCD touchscreen.

• Rotate Dial � Scroll through the email body.
• Press Dial � Open the full email in Gmail.
• Tap Screen � Toggle privacy mode to hide email content.
• Customize � 8 LCD themes with 6 customizable colors (background, card, text, border, and navigation).

Inbox Feed

Browse your 5 most recent emails as a visual card feed.

• Rotate Dial � Slide between emails with smooth vertical animations.
• Press Dial � Open the current email in Gmail.
• Tap Screen � Toggle privacy mode.
• Customize � 8 LCD themes with 6 customizable colors.

Keys

LCD Screen

“Unverified app” warning during sign-in

This is normal while the plugin is pending Google’s verification review. Click “Advanced” then “Go to Gmail Notifications (unsafe)” to proceed. Your data is only accessed locally on your device — nothing is sent to FlowKits servers.

Key shows “Sign In” after restarting Stream Deck

Your account session may have expired. Open the key settings and click “Sign In with Google” to reconnect.

Unread count seems wrong

Gmail’s unread count includes all unread emails in the selected label, including those in conversations you may have already seen. The count updates every 15 seconds.

Email Preview shows “(No text content available)”

Some emails are sent as HTML-only without a plain text version. The plugin will attempt to extract readable text, but heavily formatted marketing emails may not display well.