Skip to content
← Guides

App Store Connect MCP: ask Claude and ChatGPT about downloads, proceeds and reviews

Connect App Store Connect to Claude, ChatGPT and other AI assistants in minutes, and ask about downloads, proceeds and reviews next to AppsFlyer and Adapty.

The HeyMetra Team Updated 3 min read

Key takeaways

  • HeyMetra is a hosted App Store Connect MCP server: create a team key in App Store Connect, paste it into HeyMetra with your Vendor Number, and add one address to Claude, ChatGPT or any other AI assistant you use.
  • Your AI assistant reads downloads, units and proceeds by app and country from Apple's sales reports, what you earned from Apple in each fiscal period, your store listing in every market, and the reviews people wrote with the replies you published.
  • AppsFlyer, Adapty, RevenueCat and Slack connect to the same address, so your AI assistant can set App Store downloads beside the ads that brought them.
  • One team key reaches every app on the account, so a question can compare all of your apps.
  • Changes are optional. When you connect, you choose whether your AI assistant may propose them, such as a reply to a review, and nothing is sent until you approve it.

App Store Connect has your downloads, your proceeds and every review people wrote. The ads that brought those downloads are in AppsFlyer, and the subscriptions behind the proceeds are in Adapty or RevenueCat. HeyMetra is a hosted App Store Connect MCP server that puts all of them behind one address Claude, ChatGPT and the other AI assistants use, so you can ask how many of last week’s downloads came from your ads. Connecting App Store Connect takes a few minutes.

Connect App Store Connect in a few minutes

HeyMetra’s App Store Connect connector runs on our servers, so there is nothing to install:

  1. Create a team key. In App Store Connect, go to Users and Access, Integrations, App Store Connect API, and stay on the Team Keys tab; creating one needs the Admin role. Pick a role that covers sales reports and reviews, such as Admin. Download the .p8 file, which Apple lets you download only once, and copy the Issuer ID and the Key ID.
  2. Paste it into HeyMetra with your Vendor Number. The Vendor Number is the eight-digit number at the top of Payments and Financial Reports. Here you also choose whether your AI assistant may propose changes.
  3. Add HeyMetra to your AI assistant. Add https://mcp.heymetra.com/mcp as a custom connector in Claude, or in ChatGPT’s developer mode. In Claude Code it is one command.

One team key covers every app on the account. The same address works in Claude, ChatGPT, Grok, Perplexity, Claude Code, Codex, Cursor and Antigravity, and every plan starts with a seven-day free trial.

App Store Connect next to your ads and subscriptions

Here is a question in Claude that reads AppsFlyer and App Store Connect at once:

Claude
We raised Apple Search Ads bids in Germany last week. How many of the App Store downloads in Germany came from those ads?
Read AppsFlyer and App Store Connect with HeyMetra
App Store Connect counted 1,140 first-time downloads in Germany last week. AppsFlyer gives Apple Search Ads 620 installs there, for $1,850, so about $3.00 each and a little over half of the downloads. AppsFlyer counts an install when the app is first opened, so the two counts never match exactly.
Germany, last week
Apple Search Ads installs (AppsFlyer)620Other downloads (difference)520
Reply to Claude…

ChatGPT uses the same connection. Here it reads the reviews that came in after a release:

ChatGPT
Since version 3.4 went out, what are people complaining about in one-star reviews, and how many have no reply?
Used HeyMetra · App Store Connect
16 one-star reviews since 3.4, and 11 have no reply. 9 say the paywall now appears before they can try the app, 5 mention the higher price and 2 report a crash on launch. I can draft replies to the eleven for you to approve.
One-star reviews since 3.4
Paywall before trying the app9Higher price5Crash on launch2
Ask anything

Grok reads every app on the account and posts the week to Slack:

Grok
Post last week’s downloads and US proceeds for each of our apps to #mobile.
Read App Store Connect with HeyMetra
Last week: Focus Timer had 3,480 downloads worldwide and $2,940 in US proceeds, Plant Care 1,910 and $1,180, Sleep Notes 860 and $410. Proceeds are after Apple’s commission, US storefront only.
Sent to Slack with HeyMetra
Slack · #mobile

Last week, worldwide downloads and US proceeds: Focus Timer 3,480 / $2,940. Plant Care 1,910 / $1,180. Sleep Notes 860 / $410.

What do you want to know?

Downloads and proceeds come from Apple’s daily sales and trends reports, so the newest figures are yesterday’s. A few more that work well:

  • Which countries brought the most downloads last month, and which of them also had the most trials in Adapty?
  • How do last month’s App Store proceeds compare with Adapty’s App Store revenue, and why do they differ?
  • What do the title, subtitle and keywords say in our German and French listings?
  • How much did we earn from Apple in the last fiscal period, app by app?

Accounts that connect to the same place

App Store Connect is one of more than twenty accounts HeyMetra connects, each with its own sign-in or key:

  • Attribution: AppsFlyer, for installs, cost and revenue by media source and campaign. Our AppsFlyer setup guide walks through the token.
  • Subscriptions: Adapty and RevenueCat, for trials, MRR and refunds. See our guides for Adapty and RevenueCat.
  • Product analytics: PostHog, for what people do inside the app.
  • Team: Slack and email, to send what your AI assistant found.

Our guide to questions app owners ask explains why App Store proceeds, Adapty revenue and RevenueCat revenue never match.

Open-source App Store Connect MCP servers

Apple does not publish an MCP server for App Store Connect. Several open-source projects do, such as app-store-connect-mcp on PyPI. They run on your own computer, read the .p8 key from a file there, and suit developers who work in Claude Code or Cursor and want to read reviews, TestFlight crash reports or analytics reports from there.

If your questions are about downloads, proceeds and reviews next to your ads and subscriptions, or you want to ask from Claude or ChatGPT on the web, connect App Store Connect to HeyMetra.

  • #app-store-connect
  • #mcp
  • #claude
  • #chatgpt
  • #mobile-apps

Frequently asked questions

Is there an App Store Connect MCP server?

Apple does not publish one. HeyMetra is a hosted App Store Connect MCP server that works in Claude, ChatGPT and other AI assistants without installing anything. There are also open-source servers you can run on your own computer.

How do I connect App Store Connect to Claude?

With HeyMetra: in App Store Connect, go to Users and Access, Integrations, App Store Connect API, and create a team key. Paste the Issuer ID, the Key ID, the .p8 file and your Vendor Number into HeyMetra, then add HeyMetra's address, https://mcp.heymetra.com/mcp, to Claude as a custom connector.

Where do I find the Vendor Number?

In App Store Connect under Payments and Financial Reports, an eight-digit number at the top. Your apps and reviews can be read without it; downloads and proceeds need it.

Why do App Store Connect downloads differ from AppsFlyer installs?

AppsFlyer counts an install when the app is first opened. App Store Connect counts first-time downloads, with redownloads and updates counted separately. Compare whole periods and expect the two to differ.

Can the AI assistant reply to App Store reviews?

Only if you allow changes when you connect and the key's role covers reviews. Your AI assistant then drafts the reply in the chat, and nothing is published until you approve it. HeyMetra cannot undo a reply once it is published.

Your competitors already put AI to work. Start with the account you check every day.

Add it to HeyMetra once, then ask about it in the AI assistant you already pay for. Add the next one when you need it.