App Store Connect MCP Server

![npm version](https://www.npmjs.com/package/app-store-connect-mcp-server) ![License: MIT](https://opensource.org/licenses/MIT)

A Model Context Protocol (MCP) server for App Store Connect API. Analyze your iOS/macOS app performance, sales, reviews, and more directly from Cursor or Claude Desktop.

日本語版 README はこちら

Features

📱 App Management

list_apps - List all apps in your App Store Connect account
get_app - Get detailed information about a specific app
list_app_versions - List all versions for an app
list_builds - List all builds for an app

⭐ Reviews

list_reviews - List customer reviews
get_review - Get a specific review with response
respond_to_review - Respond to a customer review
delete_review_response - Delete a review response
analyze_reviews - Analyze review sentiment, rating distribution, and trends

💰 Sales & Finance Reports

get_sales_report - Get sales reports (daily/weekly/monthly/yearly)
get_finance_report - Get financial reports by region
list_region_codes - List available region codes

📊 Analytics

list_analytics_report_requests - List analytics report requests
create_analytics_report_request - Create a new analytics report request
list_analytics_reports - List available analytics reports
list_analytics_report_instances - List report instances
get_analytics_report_segments - Get report segments
download_analytics_data - Download analytics data
list_analytics_categories - List analytics categories

🔧 Performance & Diagnostics

get_perf_power_metrics - Get performance/power metrics
get_diagnostic_signatures - Get diagnostic signatures (hangs, disk writes, etc.)
get_diagnostic_logs - Get detailed diagnostic logs
list_metric_types - List metric types
list_diagnostic_types - List diagnostic types

🧪 TestFlight

list_beta_testers - List beta testers
get_beta_tester - Get tester details
invite_beta_tester - Invite a new tester
remove_beta_tester - Remove a tester
list_beta_groups - List beta groups
create_beta_group - Create a new beta group

Installation

npm install -g @shincode/app-store-connect-mcp-server

Or use npx:

npx @shincode/app-store-connect-mcp-server

Setup

1. Get API Key from App Store Connect

Go to App Store Connect
Navigate to Users and Access > Integrations > App Store Connect API
Click Generate API Key
Download the .p8 file (you can only download it once!)
Note down your Issuer ID and Key ID

2. Configure for Cursor

Add to your Cursor MCP settings (~/.cursor/mcp.json):

{
  "mcpServers": {
    "app-store-connect": {
      "command": "npx",
      "args": ["-y", "@shincode/app-store-connect-mcp-server"],
      "env": {
        "APP_STORE_CONNECT_ISSUER_ID": "your-issuer-id",
        "APP_STORE_CONNECT_KEY_ID": "your-key-id",
        "APP_STORE_CONNECT_PRIVATE_KEY_PATH": "/path/to/AuthKey_XXXXX.p8",
        "APP_STORE_CONNECT_VENDOR_NUMBER": "your-vendor-number"
      }
    }
  }
}

3. Configure for Claude Desktop

Add to Claude Desktop config:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "app-store-connect": {
      "command": "npx",
      "args": ["-y", "@shincode/app-store-connect-mcp-server"],
      "env": {
        "APP_STORE_CONNECT_ISSUER_ID": "your-issuer-id",
        "APP_STORE_CONNECT_KEY_ID": "your-key-id",
        "APP_STORE_CONNECT_PRIVATE_KEY_PATH": "/path/to/AuthKey_XXXXX.p8",
        "APP_STORE_CONNECT_VENDOR_NUMBER": "your-vendor-number"
      }
    }
  }
}

Environment Variables

| Variable | Description | Required | |----------|-------------|----------| | APP_STORE_CONNECT_ISSUER_ID | Your Issuer ID from App Store Connect | ✅ | | APP_STORE_CONNECT_KEY_ID | Your API Key ID | ✅ | | APP_STORE_CONNECT_PRIVATE_KEY_PATH | Path to your .p8 private key file | ✅ | | APP_STORE_CONNECT_PRIVATE_KEY | Private key content (alternative to path) | ✅ | | APP_STORE_CONNECT_VENDOR_NUMBER | Vendor number for sales reports | For sales |

\* Either PRIVATE_KEY_PATH or PRIVATE_KEY is required

Usage Examples

Once configured, you can ask:

"List all my apps"
"Show me the latest reviews for MyApp"
"Analyze review sentiment for my app"
"Get yesterday's sales report"
"Show performance metrics for my app"
"List beta testers"

Development

# Clone the repository
git clone https://github.com/Shin-sibainu/app-store-connect-mcp-server.git
cd app-store-connect-mcp-server

# Install dependencies
npm install

# Build
npm run build

# Run in development mode
npm run dev

License

MIT

Links

---

日本語

App Store Connect APIを利用して、iOSアプリの分析・管理を行うためのMCPサーバーです。CursorやClaude Desktopから直接アプリのパフォーマンス、売上、レビューなどを分析できます。

機能

📱 アプリ管理

アプリ一覧の取得
アプリの詳細情報
バージョン履歴
ビルド管理

⭐ レビュー

カスタマーレビューの取得
レビューへの返信・削除
レビューの感情分析・評価分布

💰 売上/財務レポート

日次/週次/月次/年次の売上レポート
地域別財務レポート
ダウンロード数・収益の確認

📊 Analytics

インプレッション数（App Storeでの表示回数）
プロダクトページビュー
セッション数
インストール/削除数

🔧 パフォーマンス・診断

CPU/メモリ/バッテリー使用量
クラッシュログ
診断シグネチャ

🧪 TestFlight

ベータテスターの管理
テスターの招待・削除
テストグループの作成

インストール

npm install -g @shincode/app-store-connect-mcp-server

または npx で直接実行：

npx @shincode/app-store-connect-mcp-server

セットアップ

1. App Store Connect で API キーを取得

App Store Connect にアクセス
ユーザーとアクセス → キー → App Store Connect API に移動
キーを生成 をクリック
.p8 ファイルをダウンロード（⚠️ 一度しかダウンロードできません！）
Issuer ID と キー ID をメモ

2. Cursor での設定

~/.cursor/mcp.json（Windows: %USERPROFILE%\.cursor\mcp.json）に以下を追加：

{
  "mcpServers": {
    "app-store-connect": {
      "command": "npx",
      "args": ["-y", "@shincode/app-store-connect-mcp-server"],
      "env": {
        "APP_STORE_CONNECT_ISSUER_ID": "あなたのIssuer ID",
        "APP_STORE_CONNECT_KEY_ID": "あなたのKey ID",
        "APP_STORE_CONNECT_PRIVATE_KEY_PATH": "/path/to/AuthKey_XXXXX.p8",
        "APP_STORE_CONNECT_VENDOR_NUMBER": "あなたのVendor Number"
      }
    }
  }
}

3. Claude Desktop での設定

設定ファイルの場所：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "app-store-connect": {
      "command": "npx",
      "args": ["-y", "@shincode/app-store-connect-mcp-server"],
      "env": {
        "APP_STORE_CONNECT_ISSUER_ID": "あなたのIssuer ID",
        "APP_STORE_CONNECT_KEY_ID": "あなたのKey ID",
        "APP_STORE_CONNECT_PRIVATE_KEY_PATH": "/path/to/AuthKey_XXXXX.p8",
        "APP_STORE_CONNECT_VENDOR_NUMBER": "あなたのVendor Number"
      }
    }
  }
}

環境変数

| 変数名 | 説明 | 必須 | |--------|------|------| | APP_STORE_CONNECT_ISSUER_ID | App Store Connect の Issuer ID | ✅ | | APP_STORE_CONNECT_KEY_ID | API キー ID | ✅ | | APP_STORE_CONNECT_PRIVATE_KEY_PATH | .p8 秘密鍵ファイルのパス | ✅ | | APP_STORE_CONNECT_PRIVATE_KEY | 秘密鍵の内容（パスの代わり） | ✅ | | APP_STORE_CONNECT_VENDOR_NUMBER | 売上レポート用のベンダー番号 | 売上用 |

\* PRIVATE_KEY_PATH または PRIVATE_KEY のいずれかが必要

使用例

設定完了後、以下のように質問できます：

「自分のアプリの一覧を表示して」
「最新のカスタマーレビューを見せて」
「レビューの傾向を分析して」
「昨日の売上レポートを取得して」
「先月の売上を分析して」
「ベータテスター一覧を表示して」
「アプリのパフォーマンスを確認して」

ライセンス

MIT

App Store Connect MCP Server