majd /ipatool

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.

★ 12,341⑂ 1,093👁 75⑃ 231● 419▤ 41
GoMITCreated 2021-05-22ipatool.dev
Download: v2.8.1v2.8.1 ↓2.8.12026-11-11
+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

Latest release

v2.8.1 v2.8.1 2026-11-11
This 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

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON