Gmail notification in Menu Bar for Mac
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.



Gmail notification in Menu Bar for Mac.

Unread messages of Gmail are checked and the number of unread messages is shown in the menu bar.

Default setting checks only Inbox. Multi-label can be set to be checked.

Short information of unread messages are shown in the menu.

New message notification is also available, too.


With Homebrew Cask, do:

$ brew cask install rcmdnk/rcmdnkcask/menubargmail

Or download the app and install it in /Applications or ~/Applications.


Launch MenuBarGmail, and click Uninstall menu from menu bar icon.

This function will remove

  • $HOME/.menubargmail_oauth
  • $HOME/.menubargmail_settings
  • $HOME/Library/LaunchAgents/menubargmail.plist
  • $HOME/Library/Application Support/MenuBarGmail/


When you start MenuBarGmail, an authentication page will be open in a browser. Accept it, then a following icon will appear in the menubar.


Following menus are available:

  • About: Show information of MenuBarGmail.
  • Account: Current account.
    • Gmail page will be open by clicking this.
  • Check now: Check mails now.
  • Reconnect: Renew account authentication.
    • If you want to change an account, login to other account in default browser, then click Reconnect.
  • Unread messages: Number and details of unread messages.
  • Set checking interval: Set interval to check mails (Default: 60 (sec)).
  • Set labels: Set labels (comma-separated) to be checked (Default: "").
  • Set filter: Set filter for mail search (Defalt: "").
  • Mail notification: Toggle if a notification is shown or not when the new message comes.
  • Start at login: Toggle if starting at login or not.
  • Uninstall: Uninstall MenuBarGmail.
  • Quit: Quit MenuBarGmail.

If both labels and filter are not set (empty), INBOX is checked (this is default).

For filter details, refer: Advanced search - Gmail Help.

Message details (Date, From, Subject, Short summary of message) can be seen as a submenu of Unread message.

If more than one mails are unread in a same thread, only the last is shown.

If two different labels are set, each label is shown as a submenu then details are shown as a submenu of it.

A pop up window with full details will be shown by clicking these submenus. On the window, Mark as read and Open in browser buttons are availabl.

How to build

Tested at OS X 10.11.1 El Capitan, Python 2.7.10 (installed by Homebrew)。

In OS X 10.11 El Capitan, you may need to install pyobjc packages.

$ pip install pyobjc-core pyobjc-framework-Accounts pyobjc-framework-AddressBook pyobjc-framework-AppleScriptKit pyobjc-framework-AppleScriptObjC pyobjc-framework-Automator pyobjc-framework-CFNetwork pyobjc-framework-CalendarStore pyobjc-framework-Cocoa pyobjc-framework-Collaboration pyobjc-framework-CoreData pyobjc-framework-CoreLocation pyobjc-framework-CoreText pyobjc-framework-CoreWLAN pyobjc-framework-DictionaryServices pyobjc-framework-DiskArbitration pyobjc-framework-EventKit pyobjc-framework-ExceptionHandling pyobjc-framework-FSEvents pyobjc-framework-InputMethodKit pyobjc-framework-InstallerPlugins pyobjc-framework-InstantMessage pyobjc-framework-LatentSemanticMapping pyobjc-framework-LaunchServices pyobjc-framework-OpenDirectory pyobjc-framework-PreferencePanes pyobjc-framework-PubSub pyobjc-framework-QTKit pyobjc-framework-Quartz pyobjc-framework-ScreenSaver pyobjc-framework-ScriptingBridge pyobjc-framework-SearchKit pyobjc-framework-ServiceManagement pyobjc-framework-Social pyobjc-framework-StoreKit pyobjc-framework-SyncServices pyobjc-framework-SystemConfiguration pyobjc-framework-WebKit
  • Build

    $ python py2app

then, will appear in ./dist directory.