app-store-connect-mcp

module

v0.17.0 Latest Latest Go to latest Published: Oct 28, 2026 License: MIT

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/idoo/app-store-connect-mcp

Links

Open Source Insights

README ¶

A goose drives an old boxy car past a WAITING FOR REVIEW sign. In the back seat a guy in a grey hoodie with a bitten apple for a head cheers, and a cartoon Viking laughs while filming it on his phone. Fuzzy dice hang from the mirror.

app-store-connect-mcp

MCP server for App Store Connect. MCP is the plug-in format AI clients like Claude, Cursor and Codex use, so with this one your agent can read and manage your App Store Connect account. Read-only by default, and it asks before anything goes public. The binary is app-store-connect-mcp.

Install

Paste this into whatever AI is writing your app right now (we won't tell):

Set up the app-store-connect-mcp server for me: https://github.com/idoo/app-store-connect-mcp/blob/main/docs/INSTALL.md

Or by hand, in three steps:

curl -fsSL https://github.com/idoo/app-store-connect-mcp/releases/latest/download/install.sh | sh   # or: brew install idoo/tap/app-store-connect-mcp
app-store-connect-mcp auth add                    # asks for your API key, tests it with Apple
app-store-connect-mcp config install claude-code  # or claude-desktop, cursor, codex, vscode, windsurf

Details in docs/INSTALL.md. Upgrading, key rotation and fixes for common errors: docs/FAQ.md.

Why you can trust it

You're handing it an App Store Connect key, so here's what you can check yourself instead of taking my word for it:

All of it is here. MIT, no closed parts. Build it yourself with go install github.com/idoo/app-store-connect-mcp/cmd/app-store-connect-mcp@latest.
Read-only until you say otherwise. Write tools aren't even listed until you turn writes on, and anything public or hard to undo shows a preview and waits for your yes. docs/SAFETY.md
No telemetry. It talks to api.appstoreconnect.apple.com, the presigned upload and report URLs Apple hands back (sent without your token), and the public iTunes Search API for store_lookup. After web login it also reads appstoreconnect.apple.com (App Analytics, Payments, the web toolset) and Apple's own sign-in pages. The JWT is signed on your machine and only ever goes to the API. SECURITY.md
Your key stays where you put it. It's read from a file, an env var or the OS keychain. The config holds only a path or keychain reference, is written 0600, and is refused if anyone else can write to it. Apple ID cookies live in the Keychain. No MCP tool can add or change credentials.
Releases are signed and traceable to their source. Every release is built by release.yml from a tag, published as an immutable release, and ships an SPDX SBOM per archive, a cosign keyless signature on checksums.txt, and build provenance attestations. The macOS binaries are also signed with my Developer ID and notarized by Apple, so Gatekeeper opens them without a warning.
CI scans every push with CodeQL and govulncheck, and a tag can't ship with a known reachable vulnerability.

Check a download with the GitHub CLI:

gh attestation verify app-store-connect-mcp_<version>_<os>_<arch>.tar.gz --repo idoo/app-store-connect-mcp

or with cosign:

cosign verify-blob --bundle checksums.txt.sigstore.json \
  --certificate-identity-regexp '^https://github.com/idoo/app-store-connect-mcp/\.github/workflows/release\.yml@refs/tags/v' \
  --certificate-oidc-issuer https://token.actions.githubusercontent.com checksums.txt
shasum -a 256 -c checksums.txt --ignore-missing

On a Mac, spctl -a -vv -t install app-store-connect-mcp should say source=Notarized Developer ID.

The .mcpb and tools.json are listed in checksums-extra.txt with their own checksums-extra.txt.sigstore.json. Both checks above work on them the same way.

Compared

	this one	forgeops	zelentsov	Joshua (archived)	`asc`
MCP	+	+	+	+	−
Read-only default	+	−	−	−	−
Asks before publishing	+	−	~	−	~
Injection guard	+	−	−	−	−
Release preflight	+	−	~	−	+
Sales reports	+	−	+	+	+
One binary, any OS	+	+	−	−	+

~ partial

Security

It can't break anything until you let it. Anything public, money-moving or hard to undo for your users and team waits for your yes. Build uploads and Xcode Cloud branch runs don't ask; pull request runs do. A 1-star review that says "ignore previous instructions" is still just a 1-star review. More in docs/SAFETY.md.

What it does

Everything you'd click in App Store Connect: releases, TestFlight, listings, screenshots, reviews, sales, IAPs, signing, Xcode Cloud. For everything else there's raw API access. Tool list, config.

After launch it keeps watching, if you turn on the insights toolset: post-release health with a guard that pauses a phased rollout from cron, a "what's new since yesterday" digest, the analytics funnel, and keyword rank tracking. In Claude Desktop, claude.ai, ChatGPT and VS Code the release checklist, metadata diffs, screenshots, reviews and funnel show up as small interactive views.

A toolset is a group of tools you switch on or off, so your agent only sees what you use. The release, TestFlight, metadata, reviews, reports and screenshots ones are on out of the box. Add others with --toolsets +insights,+signing or ASC_MCP_TOOLSETS=+insights, or ask the agent to turn one on mid-chat. The list is in docs/CONFIG.md.

Stats without an Admin key or vendor number

Apple's Analytics Reports need an Admin key and a day or two before the first numbers, and sales need the vendor number, which the API doesn't expose. After app-store-connect-mcp web login neither matters: the vendor number is read from Payments once and remembered, and analytics_funnel_report and insights_summary read App Analytics the way the website does. insights_summary without an app lists every app's impressions, page views, downloads, sessions and crashes against the previous period.

Creating apps and App Privacy

Apple's API can't create an app record or fill in App Privacy. The opt-in web toolset can, through your Apple ID instead of the API key. You sign in once:

app-store-connect-mcp web login

A browser window opens on Apple's own sign-in page. Type your password, approve 2FA or use a passkey, and the window closes by itself. It's a separate browser profile just for this: your default browser if it's Brave, Chrome, Edge or Arc, another one of those if it isn't, or a downloaded Chrome for Testing when you have none. When the session runs out later, the same profile renews it headless, so mostly you won't see a window again. An agent can open the window too, with the web_login tool, when a tool says web_session_required.

No screen? web login --password keeps the old terminal flow (Apple ID, password, 2FA code), though Apple often refuses it with error -20209. On an SSH box, use web import with the cookies from a browser's "Copy as cURL" or a FASTLANE_SESSION.

Then turn the toolset on (--toolsets +web) and ask for apps_create, privacy_get, privacy_plan and privacy_apply. The agent never sees your Apple ID, password or cookies: the cookies stay in your Keychain and the password isn't stored anywhere. Creating an app and publishing App Privacy each wait for your yes. Details in docs/CONFIG.md.

License

Directories ¶

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL

Path	Synopsis
cmd
app-store-connect-mcp command Command app-store-connect-mcp is the App Store Connect MCP server.	Command app-store-connect-mcp is the App Store Connect MCP server.
internal
app Package app wires configuration, credentials, the App Store Connect client and local state into a tool.Env, and runs the MCP server.	Package app wires configuration, credentials, the App Store Connect client and local state into a tool.Env, and runs the MCP server.
applemeta Package applemeta pins Apple domain tables shared across app-store-connect-mcp: screenshot display types and pixel sizes, App Store locales, field length limits, and Sales and Trends report parameters and date rules.	Package applemeta pins Apple domain tables shared across app-store-connect-mcp: screenshot display types and pixel sizes, App Store locales, field length limits, and Sales and Trends report parameters and date rules.
asc Package asc is the App Store Connect HTTP client: retries, rate limits, pagination, cursors, error hints, compaction, redaction and the read-only guard.	Package asc is the App Store Connect HTTP client: retries, rate limits, pagination, cursors, error hints, compaction, redaction and the read-only guard.
ascrules Package ascrules holds App Store Connect behaviour rules shared by the client and the tool packages: the eventual-consistency read flag and the per-operation "already exists" answers.	Package ascrules holds App Store Connect behaviour rules shared by the client and the tool packages: the eventual-consistency read flag and the per-operation "already exists" answers.
asctest Package asctest provides a fake App Store Connect server that checks every request against the pinned spec.	Package asctest provides a fake App Store Connect server that checks every request against the pinned spec.
auth Package auth signs App Store Connect ES256 JWTs (team and individual keys) and caches tokens per profile.	Package auth signs App Store Connect ES256 JWTs (team and individual keys) and caches tokens per profile.
browser Package browser drives a dedicated Chromium-based browser profile through a sign-in on the vendor's own web page and captures the resulting session cookies over the DevTools protocol.	Package browser drives a dedicated Chromium-based browser profile through a sign-in on the vendor's own web page and captures the resulting session cookies over the DevTools protocol.
config Package config loads profiles, project pins, environment and mode flags, and checks config file permissions.	Package config loads profiles, project pins, environment and mode flags, and checks config file permissions.
mcpserver Package mcpserver builds the MCP server from the tool registry: toolsets, read-only withholding, plans, elicitation, resources, prompts and transports.	Package mcpserver builds the MCP server from the tool registry: toolsets, read-only withholding, plans, elicitation, resources, prompts and transports.
metadata Package metadata is the App Store listing-metadata engine shared by release_prepare (What's New) and the metadata_* tools: it pulls version and app-info localizations, diffs a desired listing against them, applies the resulting plan, and reads/writes the fastlane, Expo and JSON formats.	Package metadata is the App Store listing-metadata engine shared by release_prepare (What's New) and the metadata_* tools: it pulls version and app-info localizations, diffs a desired listing against them, applies the resulting plan, and reads/writes the fastlane, Expo and JSON formats.
netpolicy Package netpolicy is the single "may this server connect here" address predicate shared by every unauthenticated egress path (the asc fetcher and the release_status URL probes).	Package netpolicy is the single "may this server connect here" address predicate shared by every unauthenticated egress path (the asc fetcher and the release_status URL probes).
reports Package reports decodes and aggregates sales, finance and analytics report files.	Package reports decodes and aggregates sales, finance and analytics report files.
resolve Package resolve implements tool.Resolver: it turns the references people use ("Hjul", "latest", "German", "External testers") into App Store Connect ids using only the tool.ASC interface.	Package resolve implements tool.Resolver: it turns the references people use ("Hjul", "latest", "German", "External testers") into App Store Connect ids using only the tool.ASC interface.
secrets Package secrets holds the private-key and token patterns shared by the redactor ([asc.Redact]) and the approval-prompt warning ([tool.LooksLikeSecret]), so the two can never disagree about what a key looks like.	Package secrets holds the private-key and token patterns shared by the redactor ([asc.Redact]) and the approval-prompt warning ([tool.LooksLikeSecret]), so the two can never disagree about what a key looks like.
spec Package spec embeds the App Store Connect OpenAPI index and implements search, describe, validate and the sensitive-operation list.	Package spec embeds the App Store Connect OpenAPI index and implements search, describe, validate and the sensitive-operation list.
spec/gen command Command gen builds internal/spec/index.json.gz and PROVENANCE.json from Apple's App Store Connect OpenAPI document.	Command gen builds internal/spec/index.json.gz and PROVENANCE.json from Apple's App Store Connect OpenAPI document.
state Package state persists cursors and upload resume records in the XDG state directory.	Package state persists cursors and upload resume records in the XDG state directory.
tool Package tool is the contract every app-store-connect-mcp tool is written against: tool declaration (Meta, Class, Toolset, ConfirmMode), the registry, the Env of dependencies a handler may use (all interfaces, implemented elsewhere), result and error helpers, and the confirm/plan gates.	Package tool is the contract every app-store-connect-mcp tool is written against: tool declaration (Meta, Class, Toolset, ConfirmMode), the registry, the Env of dependencies a handler may use (all interfaces, implemented elsewhere), result and error helpers, and the confirm/plan gates.
tool/tooltest Package tooltest provides in-memory fakes of every tool.Env dependency and helpers to call tools directly, so tool slices unit-test handlers without the MCP server or network.	Package tooltest provides in-memory fakes of every tool.Env dependency and helpers to call tools directly, so tool slices unit-test handlers without the MCP server or network.
tools/admin Package admin registers the admin toolset: team users and invitations.	Package admin registers the admin toolset: team users and invitations.
tools/all Package all links every domain tool package so their init functions register tools with internal/tool.	Package all links every domain tool package so their init functions register tools with internal/tool.
tools/assetlib Package assetlib reads the App Store Asset Library placements of version localizations.	Package assetlib reads the App Store Asset Library placements of version localizations.
tools/core Package core registers the core toolset: diagnostics, toolset control, app lookup and the spec-backed generic API layer (asc_api_*).	Package core registers the core toolset: diagnostics, toolset control, app lookup and the spec-backed generic API layer (asc_api_*).
tools/docsgen command Command docsgen writes docs/tools.json and docs/TOOLS.md from the tool registry.	Command docsgen writes docs/tools.json and docs/TOOLS.md from the tool registry.
tools/insights Package insights holds the optional insights toolset: cross-source summaries such as release health, digests and analytics funnels.	Package insights holds the optional insights toolset: cross-source summaries such as release health, digests and analytics funnels.
tools/library Package library implements the App Store Asset Library write tools: library_plan diffs a local directory against the placements of a version, custom product page, experiment treatment or in-app event, and library_apply carries the plan out (upload, place, delete, reorder, retire).	Package library implements the App Store Asset Library write tools: library_plan diffs a local directory against the placements of a version, custom product page, experiment treatment or in-app event, and library_apply carries the plan out (upload, place, delete, reorder, retire).
tools/metadata Package metadata registers the metadata toolset: App Store localized metadata pull/plan/apply and app info updates.	Package metadata registers the metadata toolset: App Store localized metadata pull/plan/apply and app info updates.
tools/monetization Package monetization registers the monetization toolset: in-app purchases, subscriptions, pricing, availability and offers.	Package monetization registers the monetization toolset: in-app purchases, subscriptions, pricing, availability and offers.
tools/release Package release registers the release toolset: App Store release workflow: readiness preflight, version preparation, submission, publishing, phased release and builds.	Package release registers the release toolset: App Store release workflow: readiness preflight, version preparation, submission, publishing, phased release and builds.
tools/reports Package reports registers the reports toolset: sales, finance and analytics reports and the insights summary.	Package reports registers the reports toolset: sales, finance and analytics reports and the insights summary.
tools/reviews Package reviews registers the reviews toolset: customer reviews and public responses.	Package reviews registers the reviews toolset: customer reviews and public responses.
tools/screenshots Package screenshots registers the screenshots toolset: screenshot and app preview sets: listing, sync and preview uploads.	Package screenshots registers the screenshots toolset: screenshot and app preview sets: listing, sync and preview uploads.
tools/signing Package signing registers the signing toolset: bundle IDs, capabilities, certificates, profiles and devices.	Package signing registers the signing toolset: bundle IDs, capabilities, certificates, profiles and devices.
tools/store Package store registers the store toolset: public iTunes Search/Lookup (no authentication).	Package store registers the store toolset: public iTunes Search/Lookup (no authentication).
tools/testflight Package testflight registers the testflight toolset: TestFlight beta groups, testers, build distribution, feedback and build expiry.	Package testflight registers the testflight toolset: TestFlight beta groups, testers, build distribution, feedback and build expiry.
tools/uploads Package uploads registers the uploads toolset: IPA/PKG build uploads through the BuildUpload API.	Package uploads registers the uploads toolset: IPA/PKG build uploads through the BuildUpload API.
tools/web Package web registers the web toolset: App Store Connect features the public API lacks (creating app records, App Privacy), called through the human's Apple ID web session (tool.Env.Web, the iris JSON:API).	Package web registers the web toolset: App Store Connect features the public API lacks (creating app records, App Privacy), called through the human's Apple ID web session (tool.Env.Web, the iris JSON:API).
tools/webhooks Package webhooks registers the webhooks toolset: App Store Connect webhook subscriptions.	Package webhooks registers the webhooks toolset: App Store Connect webhook subscriptions.
tools/xcodecloud Package xcodecloud registers the xcodecloud toolset: Xcode Cloud workflows and build runs.	Package xcodecloud registers the xcodecloud toolset: Xcode Cloud workflows and build runs.
upload Package upload implements App Store Connect uploads: the asset flow (screenshots, previews, review screenshots, IAP/subscription images) and the BuildUpload flow for IPA/PKG files with resumable parts.	Package upload implements App Store Connect uploads: the asset flow (screenshots, previews, review screenshots, IAP/subscription images) and the BuildUpload flow for IPA/PKG files with resumable parts.
websession Package websession holds the human's App Store Connect web session (Apple ID sign-in): the cookies the browser would send to appstoreconnect.apple.com.	Package websession holds the human's App Store Connect web session (Apple ID sign-in): the cookies the browser would send to appstoreconnect.apple.com.
skills Package skills embeds app-store-connect-mcp's Agent Skills (skills/<name>/SKILL.md) so `app-store-connect-mcp skills install` can copy them into an agent's user skills directory.	Package skills embeds app-store-connect-mcp's Agent Skills (skills/<name>/SKILL.md) so `app-store-connect-mcp skills install` can copy them into an agent's user skills directory.