Gmail widget for Mac: what exists and how to see new mail without a browser

If you searched for a Gmail widget for Mac, the short answer is this: Google does not make a Mac app, so there is no native Gmail widget in the macOS widget gallery. There is still a way to get one on the desktop. On current versions of macOS, a Mac can show widgets from apps installed on your iPhone, and the Gmail iPhone app has widgets. That route works, but it depends on the phone being nearby. If what you actually want is to notice new mail without keeping a browser tab open, four other setups do that job more reliably. This guide covers the widget route step by step, then compares the alternatives on the two things that matter: whether you get notified with the browser closed, and whether the Dock icon shows an unread count.

Why the widget gallery has no Gmail entry

Widgets on the Mac come from installed apps. The Mail app ships with macOS, so Apple's own mail widgets appear. Gmail, on the other hand, is something most Mac users open in a browser tab, and a website cannot add a widget to the gallery.

Checked on October 18, 2026, the Gmail listing on the App Store lists compatibility for iPhone (iOS 18.0 or later) and iPad (iPadOS 18.0 or later), and nothing for Mac. There is no Mac build to install, which is why the gallery stays empty of Gmail.

Search results for this query also surface a Chrome Web Store extension called "Gmail App." Its developer is listed as Netvolk Online Limited, not Google. It is a browser extension, not a Mac app, so it does not add a widget either. The name is worth reading carefully before installing it.

The MacRumors forum thread that ranks for this query asks the same question in one line: is there a Gmail widget for the Sonoma desktop? The practical answer has two halves. One is borrowing the iPhone widget. The other is giving up on a widget and getting the same information from a notification and a Dock badge instead.

Route 1: put the iPhone Gmail widget on the Mac desktop

Apple's guide to adding and customizing widgets on Mac lists three requirements for using iPhone widgets:

  • The iPhone runs iOS 17 or later.
  • The iPhone and the Mac are signed in to the same Apple Account.
  • The iPhone is near the Mac or on the same Wi-Fi network.

The Gmail widget itself comes from the Gmail iPhone app. Google's help page on adding the Gmail widget says the widget needs iOS 14 or later and that a newly installed app may need to be opened once before the widget options appear.

Steps on the iPhone

  1. Install the Gmail app and open it once, signed in to the account you want to watch.
  2. Optionally test the widget on the iPhone first: touch and hold the Home Screen, tap Edit, then Add Widget, and pick Gmail.

Steps on the Mac

  1. Open System Settings and click Desktop & Dock in the sidebar.
  2. Under Widgets, turn on "Use iPhone widgets."
  3. Control-click the wallpaper and choose Edit Widgets.
  4. In the widget gallery, search for Gmail. The iPhone widgets appear alongside the Mac ones.
  5. Click the widget to place it automatically, or drag it to a spot on the desktop. Click Done.

To change which account the widget shows, Google's instructions on the iPhone are to touch and hold the widget and tap Edit Widget, then choose the account.

Where this route falls short

Apple's guide states that when you click an iPhone widget whose app is not installed on the Mac, you see a message asking you to open the app on your iPhone to continue. Gmail is exactly that case. The widget can show you that mail has arrived, but clicking it does not open the message on the Mac. You still need a browser or another app to read and reply.

The widget also depends on the phone. If the iPhone is in another room, off Wi-Fi, or switched off, the Mac has nothing fresh to show. Widgets on the desktop are also hidden behind open windows unless you click the wallpaper to reveal them. For a glance at the start of the day, this is fine. For noticing a reply within minutes while you work, it is not.

Route 2: Gmail's own desktop notifications in the browser

Gmail can send desktop notifications from a browser tab. Google's help page on changing Gmail notifications gives the steps:

  1. Open Gmail on your computer.
  2. At the top right, click Settings, then See all settings.
  3. Scroll down to "Desktop notifications."
  4. Choose New mail notifications on, Important mail notifications on, or Mail notifications off.
  5. Click Save Changes at the bottom of the page.

Two details from that page change how useful this is. First, if you use inbox categories and choose new mail notifications, you only get notified about messages in the Primary category. Mail sorted into Promotions or Updates stays silent. Second, notifications only arrive while you are signed in and Gmail is open in the browser. Close the tab or quit the browser and the alerts stop. The macOS side also has to allow it: the browser itself needs notifications turned on in System Settings, under Notifications.

This route costs nothing and keeps every Gmail feature. Its weakness is the one the reader of this query usually wants to fix: it only works while the tab is open, and the Dock icon of the browser does not show a Gmail unread count.

Route 3: the Mail app that comes with macOS

Adding the Gmail account to the built in Mail app moves notifications out of the browser entirely. Google's IMAP help says that starting January 2025, the option to enable or disable IMAP is gone, because IMAP access is always on in Gmail. In practice, the setup is: open System Settings, go to Internet Accounts, choose Google, sign in, and turn on Mail.

Once the account is added, Mail notifies you while it is running, and Apple's Dock guide notes that a red badge on the Mail icon in the Dock means there is unread mail. That is the badge most people were hoping a widget would give them.

The trade off is in how Gmail's own features translate. Labels appear as folders, so a message with three labels shows up in three places. The Primary, Social, and Promotions tabs are not reproduced, so everything lands in one inbox and the badge counts promotional mail too. Snooze and scheduled send live in the Gmail web interface and are not available from Mail. Google's help also notes a limit of 15 email clients connected to one account at a time, which matters only if you have old devices still connected.

Route 4: a Gmail web app with its own Dock icon

A middle path keeps the Gmail web interface but gives it its own window, its own Dock icon, and its own notifications. Apple's page on using Safari web apps on Mac explains the setup for macOS Sonoma 14 or later:

  1. Open Gmail in Safari.
  2. From the menu bar, choose File, then Add to Dock. The Share button in the toolbar has the same option.
  3. Enter a name and click Add.

The web app is saved in the Applications folder inside your home folder. When Gmail asks to send notifications, answer it inside the web app rather than in Safari. Apple's page explains that this is what makes the web app appear in Notifications settings under its own name and lets its Dock icon show the number of unread notifications as a red badge.

Cookies and history are kept separate from Safari, so signing out in Safari does not sign out the web app. The web app can use Safari extensions, enabled per app from its settings, but not Chrome Web Store extensions. Chrome offers a similar feature under the menu as Cast, Save, and Share, then Install page as app, though an installed Chrome app shares the Chrome profile's sign in.

Note what the badge counts here. It reflects notifications Gmail has sent, which follows Gmail's notification setting from Route 2. If notifications are set to Important mail only, the badge stays quiet for everything else.

Route 5: a dedicated Gmail client

The last option is a Mac email app built only for Gmail. Mimestream is one that ranks for this query. It uses the Gmail API, so labels, inbox categories, and server side filters behave the way they do on the web. Checked on October 18, 2026, the Mimestream pricing page lists an individual plan at $49.99 per year or $4.99 per month, a 14 day free trial with no credit card, use on up to 5 devices, and no one time purchase option. It is sold directly rather than through the App Store.

This route suits someone who lives in Gmail all day and relies on labels and filters. It is a subscription, and it handles Gmail accounts rather than every mail provider.

The five routes side by side

What you want iPhone widget Browser tab alerts Mail app Safari web app Dedicated client
Works with browser closed Yes, if iPhone is near No Yes, while Mail runs Yes, while the app runs Yes
Dock unread badge No No Yes Yes Yes
Opens the message on the Mac No Yes Yes Yes Yes
Gmail labels and tabs intact Not applicable Yes Labels become folders Yes Yes
Cost Free Free Free Free $49.99 per year

Read the table from the top. If a glance at the desktop once in a while is enough and the phone is always with you, the iPhone widget is the closest thing to what the search asked for. If the real goal is to stop missing mail while the browser is closed, the Mail app and the Safari web app both deliver a badge and a notification at no cost. Pick Mail if you do not use labels, and the web app if you do.

When there is more than one Gmail account

Two accounts change the picture. The iPhone widget shows one account at a time. The Mail app can show both, but merges them into one badge. In Chrome, installed apps share the profile's sign in, so switching accounts in one window can switch the other. Safari web apps keep their data apart from Safari itself, and the cleanest setup is one web app per account, each signed in once and left alone.

A site to app tool that gives each app its own browser profile solves this structurally. Each Gmail window keeps its own cookies and sign in, so a work inbox and a personal inbox can sit in the Dock as two icons, each with its own notifications. Some of these tools build on Chrome or other Chromium browsers, so extensions keep working. The Features page describes per app profiles and the notification switch, and the Guide shows the setting that lets a site's notifications appear in macOS Notification Center.

What to change first

Turn on "Use iPhone widgets" if a desktop glance is all you need. If you want alerts with the browser closed, make Gmail a Safari web app today and allow notifications inside it, or move to the Mail app if you never use labels. For several Gmail accounts in separate windows, a per app profile tool such as Kagemusha is free for up to three apps.

Frequently asked questions

Is there an official Gmail widget for macOS?

No. Google does not publish a Mac version of the Gmail app, so the macOS widget gallery has no Gmail widget of its own. The Gmail iPhone app does have widgets, and a Mac on a current version of macOS can display iPhone widgets when "Use iPhone widgets" is turned on in Desktop & Dock settings.

Why does clicking the Gmail widget on my Mac ask me to open my iPhone?

The widget comes from the iPhone app, and the Gmail app is not installed on the Mac. Apple's guide explains that in this case clicking the widget shows a message asking you to open the app on the iPhone. To read the message on the Mac, open Gmail in a browser, a web app, or a mail client.

Why do I only get Gmail notifications for some emails?

If inbox categories are on and you chose new mail notifications, Gmail only notifies you about messages in the Primary category. If you chose important mail notifications, only messages Gmail marks as important trigger an alert. Change the option under Desktop notifications in Gmail's settings.

Can I get a Gmail unread count on the Dock without the Mail app?

Yes. Save Gmail as a Safari web app with File, then Add to Dock, and allow notifications inside the web app. Apple's documentation says the web app's Dock icon then shows the number of unread notifications as a red badge. The count follows Gmail's notification setting.

Back to all posts