App Store Connect MCP

An MCP server for App Store Connect that works with Claude Desktop and Claude Code.

It focuses on two practical workflows:

• Read App Store Connect app and version data
• Read App Analytics report pipelines and safely prepare metadata updates

Features

App tools

• list_apps
• get_app
• list_app_infos
• get_app_info_localizations
• get_app_store_versions
• get_app_store_version_localizations

Analytics tools

• list_analytics_report_requests
• create_analytics_report_request
• get_analytics_report_request_status
• diagnose_analytics_pipeline
• list_analytics_reports
• list_analytics_report_instances
• list_analytics_report_segments
• download_analytics_report_segment
• reset_analytics_report_request

Sales and finance tools

• download_sales_report
• summarize_app_sales_report
• download_finance_report

Metadata tools

• update_app_info_localization
• update_app_store_version_localization

Security

This project is designed to avoid storing credentials in source control.

• Do not commit .env
• Do not commit *.p8
• Store your App Store Connect private key outside the repository
• Use dryRun=true before any metadata update
• Real metadata changes require dryRun=false and confirm=true

The server only reads credentials from environment variables:

• APP_STORE_CONNECT_ISSUER_ID
• APP_STORE_CONNECT_KEY_ID
• APP_STORE_CONNECT_PRIVATE_KEY_PATH
• APP_STORE_CONNECT_VENDOR_NUMBER

Project structure

src/
  index.ts
  config.ts
  auth.ts
  client.ts
  types.ts
  tools/
    apps.ts
    analytics.ts
    metadata.ts
    shared.ts

Requirements

• Node.js 20+
• An App Store Connect API key
• Access to the App Store Connect API for your Apple account

Setup

1. Install dependencies

npm install

2. Create your environment file

Copy .env.example to .env and fill in your own values:

cp .env.example .env

Example:

APP_STORE_CONNECT_ISSUER_ID=YOUR_ISSUER_ID
APP_STORE_CONNECT_KEY_ID=YOUR_KEY_ID
APP_STORE_CONNECT_PRIVATE_KEY_PATH=/absolute/path/to/AuthKey_XXXXXXXXXX.p8
APP_STORE_CONNECT_VENDOR_NUMBER=YOUR_VENDOR_NUMBER

3. Build

npm run build

Run locally

Development:

npm run dev

Production build:

npm start

Scripts

• npm run dev — run the server from TypeScript source
• npm run build — compile TypeScript to dist/
• npm start — start the built MCP server
• npm run test:connection — test the App Store Connect connection
• npm run inspect — run a local MCP client against the server

Claude Code setup

Option 1: project-scoped config

This repository includes a shareable .mcp.json:

{
  "mcpServers": {
    "app-store-connect": {
      "command": "npm",
      "args": ["start"]
    }
  }
}

If Claude Code is opened in this project, it can use that project config.

Option 2: user-scoped config

claude mcp add app-store-connect -s user \
  -e APP_STORE_CONNECT_ISSUER_ID=YOUR_ISSUER_ID \
  -e APP_STORE_CONNECT_KEY_ID=YOUR_KEY_ID \
  -e APP_STORE_CONNECT_PRIVATE_KEY_PATH=/absolute/path/to/AuthKey_XXXXXXXXXX.p8 \
  -- node /absolute/path/to/app-store-connect-mcp/dist/index.js

Claude Desktop setup

Add this to claude_desktop_config.json:

{
  "mcpServers": {
    "app-store-connect": {
      "command": "node",
      "args": [
        "/absolute/path/to/app-store-connect-mcp/dist/index.js"
      ],
      "env": {
        "APP_STORE_CONNECT_ISSUER_ID": "YOUR_ISSUER_ID",
        "APP_STORE_CONNECT_KEY_ID": "YOUR_KEY_ID",
        "APP_STORE_CONNECT_PRIVATE_KEY_PATH": "/absolute/path/to/AuthKey_XXXXXXXXXX.p8"
      }
    }
  }
}

Restart Claude Desktop after saving the config.

Example prompts

Try these in Claude:

• Run the list_apps tool and show my apps
• Use get_app for a specific app ID
• Use list_app_infos for app 123456789 and include localizations
• Use get_app_info_localizations for a specific app info ID
• Use get_app_store_versions for app 123456789 and include localizations
• List analytics report requests for app 123456789
• Create an ONGOING analytics report request for app 123456789
• Diagnose the analytics pipeline for app 123456789
• Get analytics request status for request abc123
• Reset analytics report request abc123 for app 123456789 as ONGOING
• Summarize the latest SALES summary report for app 123456789
• Download the SUBSCRIPTION daily report for my vendor number
• Run update_app_info_localization in dry run mode to compare a title or subtitle change
• Run update_app_store_version_localization in dry run mode and compare the proposed changes

Troubleshooting analytics reports

If App Store Connect shows Analytics data in the web UI but MCP cannot download analytics reports, the usual cause is that Apple hasn't generated report instances yet for the Analytics Reports API.

Recommended workflow:

1. Run diagnose_analytics_pipeline for the app ID.
2. If the result is NO_REQUEST, create an ONGOING request.
3. If the result is NO_INSTANCES, wait 1-2 days after the request was created. Apple documents that the first request can take that long before instances appear.
4. If the result is STOPPED_DUE_TO_INACTIVITY, use reset_analytics_report_request to replace the inactive request.
5. If you need older backfill, create a ONE_TIME_SNAPSHOT request. Apple allows one snapshot request per month.

Important notes from Apple:

• The first time a report type is requested, an Admin role may be required.
• Once a report type has been requested, Sales and Reports or Finance roles can download generated reports.
• Report instances expire after 35 days, so historical recovery may require a new ONE_TIME_SNAPSHOT request.

Notes on permissions

Different App Store Connect API roles can unlock different endpoints.

• App metadata and localization work typically require App Manager or broader
• Analytics report management may require Admin, depending on the endpoint
• Sales and Trends reports typically require Sales and Reports
• Finance reports typically require Finance

If a tool returns 403 FORBIDDEN_ERROR, check the role attached to your App Store Connect API key.

Output behavior

• stdout is reserved for MCP protocol traffic
• Logs are sent to stderr
• Credentials and private key contents are never printed by this project

License

MIT