[macOS] Use mas CLI to install Mac App for scripting and automation
mas is a simple command line interface for the Mac App Store - https://www.apple.com/app-store/. Designed for scripting and automation.
Homebrew - https://brew.sh/ is the preferred way to install:
brew install mas
Each application in the Mac App Store has a product identifier which is also used for mas-cli commands. Using mas list will show all installed applications and their product identifiers.
It is possible to search for applications by name using mas search which will search the Mac App Store and return matching identifiers. Include the
--price flag to include prices in the result.
mas search Xcode
To install or update an application simply run mas install with an application identifier:
mas install 808809998
If you want to install the first result that the search command returns, use the lucky command.
mas lucky twitter
Please note that this command will not allow you to install (or even purchase) an app for the first time: use the
purchase command in that case.
mas purchase 768053424
Please note that you may have to re-authenticate yourself in the App Store to complete the purchase. This is the case if the application is not free or if you configured your account not to remember the credentials for free purchases.
mas outdated to list all applications with pending updates.
mas is only able to install/update applications that are listed in the Mac App Store itself. Use
softwareupdate(8) utility for downloading system updates (like iTunes, Xcode Command Line Tools, etc)
To install all pending updates run mas upgrade.
Updates can be performed selectively by providing the app identifier(s) to mas upgrade
mas upgrade 715768417
To sign into the Mac App Store for the first time run
mas signin [email protected]
⚠️ Due to breaking changes in the underlying API that mas uses to interact with the Mac App Store, the signin command has been temporarily disabled on macOS 10.13+ ⛔. For more information on this issue, see #164.
If you experience issues signing in this way, you can ask to signin using a graphical dialog (provided by Mac App Store application):
mas signin --dialog [email protected]
You can also embed your password in the command.
mas signin [email protected] 'ZdkM4f$gzF;gX3ABXNLf8KcCt.x.np'
mas signout to sign out from the Mac App Store.
When something doesn’t work
If you see the error “This redownload is not available for this Apple ID either because it was bought by a different user of the item was refunded or cancelled.”, it’s probably because you haven’t installed the app through the App Store yet. See #46 - https://github.com/mas-cli/mas/issues/46#issuecomment-248581233.
If mas doesn’t work for you as expected (e.g. you can’t update/download apps), run mas reset and try again. If the issue persists, please file a bug - https://github.com/mas-cli/mas/issues/new! All your feedback is much appreciated ✨
mas operates via the same system services as the Mac App Store. These exist as separate processes with communication through XPC. As a result of this, mas experiences similar problems as the pasteboard when running inside tmux. A wrapper tool exists - https://github.com/ChrisJohnsen/tmux-MacOSX-pasteboard to fix pasteboard behaviour which also works for mas.
You should consider configuring tmux to use the wrapper but if you do not wish to do this it can be used on a one-off basis as follows:
brew install reattach-to-user-namespace
 mas-cli/mas: Mac App Store command line interface - https://github.com/mas-cli/mas