Gmail in its own window, with notifications that work

Searching for a Gmail Mac app turns up an App Store listing for iPhone, a Chrome extension, a native mail client that costs money, and a long forum thread where people argue about which one counts. None of those is Google shipping a Gmail application for macOS, because Google does not. On a computer, Gmail is a website.

That leaves two different questions tangled together, and separating them makes the decision much easier. One is whether to keep using Gmail's own interface, with its labels, filters, search operators and categories, or to hand the mailbox to a program that rebuilds email its own way. The other is where the window lives. Most advice on this topic answers the first question when the reader was asking the second.

What Google actually publishes

Google's Gmail apps are for Android and iOS. The marketing site for Gmail carries no download for macOS or Windows, and the Gmail Help pages for computers describe using Gmail in a browser. There is no disk image to fetch and no App Store listing to install.

There is, however, something revealing in Gmail's own code. Every site that wants to be installable publishes a web app manifest, a small file telling browsers what the installed version should be called and how its window should look. Gmail publishes one. It names the app Gmail, sets its scope to the mail path, and sets a start address that marks the launch as coming from an installed web app.

The interesting field is the display mode, and Gmail sets it to browser.

That value is a request not to be given a separate window. A site asking for standalone wants a plain window with no browser furniture. A site asking for minimal-ui wants a window with reduced controls. Gmail asks for neither. Google Calendar makes the same request, while Google Chat asks for standalone, which is why installing different Google services through the same browser command does not produce consistent results.

This is not a bug and there is nothing to fix. It simply means the browser route to a Gmail window is working against the site's stated preference rather than with it, and it explains why people report that installing Gmail through Chrome feels less like an app than they expected.

The routes, side by side

Route Gmail's own interface Own sign-in store Requirement
Browser tab Yes Shared with the browser None
Chrome, install page as app Yes Shared with the Chrome profile Chrome
Safari, Add to Dock Yes Separate macOS Sonoma 14 or later
Apple Mail No, rebuilt as mailboxes Separate, account based Built into macOS
Third-party native client No, rebuilt Separate, account based Purchase or subscription
Site to app tool Yes Separate per app A one-time setup

The first column is the real fork in the road. Anyone who relies on Gmail's search operators, its category tabs, or filters that were built up over a decade should stay in the top half of the table, because a native client reconstructs email around a mailbox rather than around labels. Anyone who prefers a conventional mail program and can live without Gmail's interface has the bottom half available, and Apple's built-in Mail adds a Google account without costing anything.

Safari's Add to Dock

Since macOS Sonoma 14, Safari can turn a page into what Apple calls a web app. The menu command is File then Add to Dock, and the same command appears under the Share button in the toolbar. The result is saved into the Applications folder inside the home folder and can be launched from the Dock or from Spotlight.

The first launch behaves in a way people often mistake for a fault:

A web app functions independently of Safari. It shares no browsing history, cookies, website data, or settings with Safari. Source: support.apple.com

So even on a Mac where Safari is signed into Google, the new app asks for a sign-in. It asks once. After that the session belongs to the app, which is exactly the property that makes it useful for something kept open all day: clearing Safari's data, or signing out of Google in a browser tab, leaves the mail window alone.

Unlike the Chrome route, Safari's Add to Dock does not consult the site's display preference. The window is independent regardless of what the manifest asks for, and the app's own settings panel lets the navigation controls be switched off entirely, which removes the back and forward buttons and the Share button from the toolbar. For Gmail that produces something very close to a plain application window.

Where the app lives, and how to reset it

An app holding a mail account is worth understanding before it breaks rather than afterwards. Apple's web apps are saved to the Applications folder inside the home folder, and removing one means opening that folder and dragging the app to the Trash. There is no installer to run and nothing left behind in a system directory.

The settings panel reached from the app's name in the menu bar carries more than cosmetic options. The application name and icon can be changed, which matters when several mail windows are open and the Dock needs to distinguish a work mailbox from a personal one at a glance. The application URL can be edited or set to whatever page is currently open, so a window can be pointed at a specific account index or at a saved search rather than the default inbox.

Two tabs in that panel do the repair work. The Privacy tab clears the website's data for that app alone, cookies and caches included, which is the fix for a sign-in loop or a session that has stopped loading, and it touches nothing in Safari or in any other web app. The Extensions tab enables or disables Safari extensions for that app individually, so a password manager can be present in a mail window while everything else stays out of it.

Notifications, and why they usually do not arrive

This is where most setups fail, because Gmail requires two separate switches and people find only one of them.

The first switch is inside Gmail itself, and it is off unless somebody turned it on. Google's help describes the path: open Gmail, click Settings at the top right, then See all settings, scroll down to the section headed Desktop notifications, and choose between new mail notifications, important mail notifications, or off. The change does not take effect until Save Changes is clicked at the bottom of the page, which is a step that gets missed often enough to be worth stating on its own.

One consequence of that setting deserves attention. Google notes that when inbox categories are in use and notifications are set to new mail, only messages landing in the Primary category generate a notification. A mailbox that files most incoming mail into Promotions or Updates will therefore look silent even when the setting is correct.

The second switch is the permission, and this is where the web app route differs from the browser. Apple states that the notification permission has to be answered inside the web app rather than in Safari, and only then does the app appear under its own name in Notifications settings. A permission granted months ago in a Safari tab does not carry across to the app built from that page.

Getting both right produces something a tab cannot do. Apple documents that a web app's Dock icon can display the number of unread notifications as a red badge, in the way a native mail program does, and that the app can be added as a login item so it opens automatically at sign-in.

Two accounts, and the number in the address

A personal account and a work account open at the same time is the most common requirement that breaks the simple routes, and the reason is structural. A browser profile holds one set of signed-in sessions per site, so a second account inside the same profile means switching rather than running both.

Gmail's own answer is the account index in the address, the segment that reads /mail/u/0/ for the first signed-in account and /mail/u/1/ for the second. An app can be built pointing at either one. The caveat worth knowing before relying on it is that the number is a position in the list of accounts signed into that session, not a permanent name for a particular account. Sign out of one, or add a third, and the position a given account occupies can move, which means a window built on a fixed index can end up showing a different mailbox than intended.

The arrangement that avoids the problem entirely is one application per account, each with its own data store, so each window signs in once to the account it belongs to and nothing shifts underneath it. That is what a site to app tool provides, and it is the main reason people reach for one after the built-in routes have been tried. The supported services list covers which sites have presets ready, and the guide explains how notifications behave in a built application.

What the native clients trade away

Apple Mail is free, already installed, and adds a Gmail account through the standard account setup. Mimestream is a paid native macOS client built specifically for Gmail on top of Google's Gmail API. Both are legitimate answers to the question, and for some people they are a better answer than any window trick.

What they trade is the interface itself. Gmail's labels, its search operators, its category tabs and its filter rules are features of the Gmail web application, and a separate program reconstructs as much of that as its developers chose to build. How close it gets varies by client, which is why the forum threads on this topic never reach agreement.

The honest test is a small one. Look at how mail was found in Gmail over the last week. If the answer involves search operators, a stack of labels, or rules that fire on arrival, the interface is the product and moving away from it costs more than it saves. If the answer is that the inbox is read top to bottom, a native client will feel better than a website in a window and there is no reason to fight it.

What to change first

Turn on Desktop notifications in Gmail's settings and save the change, because that one step fixes the complaint behind most of these searches. Then, on macOS Sonoma 14 or later with a single account, add mail.google.com to the Dock from Safari and answer the notification prompt inside the new app. For two accounts, or on an older Mac, build one application per mailbox with Kagemusha so each window keeps its own sign-in.

Frequently asked questions

Is there an official Gmail app for Mac?

No. Google publishes Gmail apps for Android and iOS, and on a computer Gmail is a website used in a browser. Every desktop option is either a browser feature that gives the site a window or a separate mail program that connects to the account.

Why does the installed Gmail app still look like a browser window?

Because Gmail's own web app manifest sets its display mode to browser, which is a request not to be given a separate window. Safari's Add to Dock ignores that preference and produces an independent window anyway, which is why the two routes do not look alike.

Gmail notifications are switched on but nothing appears. What is missing?

Usually the second switch. Gmail's own Desktop notifications setting has to be on and saved, and the browser or web app also has to hold the notification permission. In a Safari web app that permission must be answered inside the app itself, since one granted earlier in Safari does not transfer.

Can a Dock icon show the number of unread messages?

Yes, through Apple's web apps. The unread notification count appears as a red badge on the app's icon in the Dock, provided the site's notification request was allowed from inside the web app rather than in the browser.

How can two Gmail accounts have separate windows on one Mac?

Each window needs its own data store, because a single browser profile holds one signed-in session per site. That means either a second browser profile or one built application per account, each signed in separately so neither affects the other.

Is Apple Mail a reasonable substitute for the Gmail website?

It depends entirely on how the mailbox is used. Apple Mail adds a Google account for free and gives a conventional mail program, but it presents email as mailboxes rather than as Gmail's labels, categories and search operators, so a workflow built on those features will not transfer unchanged.

Back to all posts