Gmail Unread Count

Unread message count badges for one or more Gmail labels, shown as a pill row. Zero counts are displayed in grey; non-zero in the accent colour.

Surfaces

google-apps-script-webgoogle-meet-stagemcp-apps ⚠

Degraded on

Surface	Note
mcp-apps	renders sample data — live Google Workspace data requires an Apps Script deployment

Fields

Field	Type
labels	array. Gmail label names to count. Default ["INBOX"].	optional
title	string. Card heading. Default is "Gmail".	optional
accent	string. Badge colour for non-zero counts. Default red.	optional
counts	object (static connector). Label→count map for non-GAS surfaces.	required
auth_token	string (api connector). OAuth2 bearer token for REST API.	required

Example payload

{
  "type": "gmail_unread_count",
  "counts": "42",
  "auth_token": "your-api-token"
}

ARD catalog entry

{
  "identifier": "urn:air:a2uicatalog.ai:atom:gmail_unread_count",
  "displayName": "Gmail Unread Count",
  "type": "application/vnd.a2ui.atom+json",
  "url": "https://a2uicatalog.ai/atoms/gmail_unread_count",
  "capabilities": [
    "google-apps-script-web",
    "google-meet-stage",
    "mcp-apps"
  ],
  "description": "Unread message count badges for one or more Gmail labels, shown as a pill row. Zero counts are displayed in grey; non-zero in the accent colour.",
  "representativeQueries": [
    "show a unread count badges for Gmail labels",
    "unread message count badges for one or more gmail labels, shown as a pill row. zero counts are displ",
    "render a gmail unread count"
  ]
}

← Full ARD catalog

Deploy your own Google Apps Script renderer

The renderer is an open-source Google Apps Script web app. Deploy your own instance in 4 commands — you own the URL, no dependency on the demo endpoint.

git clone https://github.com/a2uicatalog/a2ui
cd a2ui/apps-script-surface/gas-wired-renderer
clasp push && clasp deploy

Full deploy guide →