+4
Daily
12,341
stars
1,093
forks
75
watchers
231
prs
419
issues
41
releases
README
ipatool is a command line tool that allows you to search for iOS, iPadOS, tvOS, watchOS, visionOS, and macOS apps on the App Store, and download .ipa or macOS .pkg app packages.
Requirements
- A supported operating system (macOS, Linux, Windows or iOS).
- An Apple Account already configured to use the App Store.
Installation
Linux and Windows
You can grab the latest version of ipatool from GitHub releases.
macOS
You can install ipatool using Homebrew.
shell
$ brew install ipatool
Usage
To get started, run the following command.
text
$ ipatool --help
A cli tool for interacting with Apple's ipa files
Usage:
ipatool [command]
Available Commands:
auth Authenticate with the App Store
completion Generate the autocompletion script for the specified shell
download Download iOS, iPadOS, tvOS, watchOS, visionOS, and macOS app packages from the App Store
get-version-metadata Retrieves the metadata for a specific version of an app
help Help about any command
list-purchases List apps owned by the authenticated App Store account
list-versions List the available versions of an App Store app
mcp Serve App Store tools over MCP using stdio
purchase Obtain a license for the app from the App Store
search Search for iOS, iPadOS, tvOS, watchOS, visionOS, and macOS apps available on the App Store
Flags:
--format format sets output format for command; can be 'text', 'json' (default text)
-h, --help help for ipatool
--keychain-passphrase string passphrase for unlocking keychain
--non-interactive run in non-interactive session
--verbose enables verbose logs
-v, --version version for ipatool
Use "ipatool [command] --help" for more information about a command.
Note: the tool runs in interactive mode by default. Use the --non-interactive flag
if running in an automated environment.
MCP tools
Run ipatool auth login in a terminal, then configure your MCP client to launch the stdio server:
json
{
"mcpServers": {
"ipatool": {
"command": "ipatool",
"args": ["mcp"]
}
}
}
Compiling
The tool can be compiled using the Go toolchain.
shell
$ go build -o ipatool
Unit tests can be executed with the following commands.
shell
$ go generate ./...
$ go test -v ./...
License
ipatool is released under the MIT license.Top issues
#380Support for TestFlight Links6 comments · 2025-07-05#235Support multiple accounts5 comments · 2023-10-23#666Purchase fails for US accounts with 'Account Not In This Store' (FailureType -128) despite matching storefront2 comments · 2026-11-12#665Purchase fails for JP storefront: guest bridge 'unsupported import dyld_lazy_load' in AMSOpenURL2 comments · 2026-11-12#168FIDO login support2 comments · 2023-03-26#206Check for licenses from Family Sharing1 comments · 2023-06-12#672[v2.8.1] download and list-versions fail with "available storefronts request failed" (404): no fallback to the built-in storefront map0 comments · 2026-11-15#671FCS key download is not retried: a transient EOF aborts the whole download0 comments · 2026-11-14
Latest release
v2.8.1 v2.8.1 2026-11-11This release adds parallel downloads and dynamic storefront discovery, and improves authentication and recovery of delisted apps. Added parallel download streams for large app packages. Added dynamic App Store storefront discovery to support regions missing from the built-in list. Improved recovery of previously acquired, delisted iOS apps. Improved sign-in errors by displaying Apple's authentication dialogs and links for required account actions. Reduced memory usage and startup time, with faster initial setup. Full Changelog: https://github.com/majd/ipatool/compare/v2.8.0...v2