Skip to main content
Glama

App Store Connect MCP Server

by TrialAndErrorAI
GitHub
TypeScript
4
  • Apple
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

App Store Connect MCP Server

By Trial and Error Inc
The reliable bridge between App Store Connect and AI assistants

TypeScript MCP SDK License: MIT Status: Alpha

Problem

You need iOS app metrics in Claude. The "official" MCP servers are broken. Manual exports waste hours. This fixes that.

Solution

A working MCP server for App Store Connect. Built in 3 hours. No dependencies on broken packages. It just works.

Quick Start

# Clone the repo git clone https://github.com/TrialAndErrorAI/appstore-connect-mcp cd appstore-connect-mcp # Install dependencies npm install # Build npm run build # Configure Claude Desktop # Add to ~/Library/Application Support/Claude/claude_desktop_config.json: { "mcpServers": { "appstore-connect": { "command": "node", "args": ["/path/to/appstore-connect-mcp/dist/index.js"], "env": { "APP_STORE_KEY_ID": "YOUR_KEY_ID", "APP_STORE_ISSUER_ID": "YOUR_ISSUER_ID", "APP_STORE_P8_PATH": "/path/to/key.p8" } } } } # Restart Claude Desktop

Getting App Store Connect Credentials

  1. Go to App Store Connect

  2. Navigate to Users and Access → Keys

  3. Click "+" to generate a new key

  4. Select "Admin" or "Finance" role

  5. Download the .p8 file (ONLY downloadable once!)

  6. Note your Key ID and Issuer ID

What You Can Ask Claude

Once configured, Claude can help you with:

  • Financial Metrics: "What's our iOS monthly recurring revenue?"

  • Subscription Analytics: "Show me active subscriber count and churn rate"

  • App Performance: "List all our iOS apps with their current versions"

  • Revenue Insights: "Calculate our ARR and growth rate"

  • API Health: "Test the App Store Connect connection"

  • Usage Monitoring: "Show API rate limit status"

More features coming soon: crash analytics, TestFlight metrics, customer reviews

Architecture

See RFC-001-architecture.md for technical details.

Project Structure

appstore-connect-mcp/ ├── PRFAQ.md # Product vision and FAQ ├── RFC-001-architecture.md # Technical specification ├── src/ │ ├── auth/ # JWT authentication │ ├── api/ # App Store Connect client │ ├── services/ # Domain logic │ └── server/ # MCP server implementation ├── tests/ # Test suite └── dist/ # Compiled output

Development

# Install dependencies npm install # Run in development mode npm run dev # Run tests npm test # Build for production npm run build # Type check npm run type-check

Why We Built This

Our portfolio company RenovateAI is ranked #28 in Design Tools on the App Store. We needed real-time iOS metrics in Claude to make data-driven decisions. The existing solutions failed us:

  • @joshuarileydev/app-store-connect-mcp-server - NPM 404 error

  • Manual API integration - Days of work, maintenance burden

  • CSV exports - Manual, error-prone, time-consuming

So we built our own. Clean, typed, reliable. In 3 hours flat.

Status

🚀 ALPHA RELEASE - MVP Complete, Ready for Testing

Completed ✅

  • PRFAQ written - Vision crystallized

  • RFC drafted - Architecture defined

  • Authentication module - JWT with P8 keys

  • API client - Rate limiting, pagination, error handling

  • MCP server - 8 tools exposed to Claude

  • Core services - App and Finance services

  • TypeScript setup - Full type safety

  • Build system - Clean compilation

  • Documentation - Setup guides and API docs

In Progress 🔄

  • Live testing with real App Store Connect account

  • Analytics service implementation

  • Comprehensive test suite

  • npm package publishing

Roadmap 📍

  • Automated testing with GitHub Actions

  • More financial report types

  • TestFlight integration

  • Customer reviews analysis

  • Crash reporting metrics

Current Status: MVP complete, awaiting App Store Connect credentials for live testing

License

MIT - Use it, modify it, sell it. Just make it work.

Available Tools

The MCP server exposes 8 tools to Claude:

Tool

Description

Status

list_apps

Get all apps in your account

✅ Ready

get_app

Get detailed app information

✅ Ready

get_sales_report

Fetch sales and subscription data

✅ Ready

get_revenue_metrics

Calculate MRR, ARR, churn

✅ Ready

get_subscription_metrics

Subscription analytics

✅ Ready

get_app_analytics

User engagement metrics

🔄 Stub

test_connection

Verify API access

✅ Ready

get_api_stats

Rate limit monitoring

✅ Ready

Troubleshooting

Common Issues

1. "Unexpected token" errors in Claude logs

Cause: Console output polluting JSON-RPC stream
Fix: Ensure no console.log statements in production code
Check: /Users/sid/Library/Logs/Claude/mcp-server-appstore-connect.log

# Look for console output in logs tail -f ~/Library/Logs/Claude/mcp-server-appstore-connect.log

2. "Illegal scope GET" error

Cause: Apple's JWT doesn't use 'scope' field
Fix: Remove scope from JWT payload in jwt-manager.ts

The JWT payload should only include:

{ "iss": "ISSUER_ID", "iat": 1234567890, "exp": 1234568890, "aud": "appstoreconnect-v1" }

3. MCP not connecting

Troubleshooting steps:

  1. Check credentials in Claude config

  2. Verify P8 file has correct permissions: chmod 600 /path/to/key.p8

  3. Test authentication manually:

    source .env && npm run test:auth

  4. Verify Claude Desktop config path: ~/Library/Application Support/Claude/claude_desktop_config.json

  5. Restart Claude Desktop after config changes

4. Financial reports error

Common fixes:

  • Add version parameter: version: "1_4" for reports

  • Vendor number required for financial data (find in App Store Connect → Payments)

  • Ensure API key has "Finance" role permissions

5. Empty or missing data

Check:

  • App ID exists and you have access permissions

  • Date ranges are valid (Apple keeps limited historical data)

  • Reports are available for your region/app

6. Rate limiting (429 errors)

Solutions:

  • Built-in exponential backoff should handle this automatically

  • If persistent, reduce request frequency

  • Check API usage: use the get_api_stats tool in Claude

7. Authentication token expired

Fix: Tokens auto-refresh every 19 minutes. If issues persist:

# Clear any cached tokens and restart rm -f ~/.appstore-connect-token-cache

Debug Mode

Enable detailed logging:

export DEBUG=appstore-connect:* npm start

Verification Commands

# Test P8 key format openssl pkey -in /path/to/key.p8 -text -noout # Test API connectivity curl -H "Authorization: Bearer $(npm run generate-token)" \ https://api.appstoreconnect.apple.com/v1/apps # Validate Claude config cat ~/Library/Application\ Support/Claude/claude_desktop_config.json | jq .

Support

Credits

Built by Trial and Error Inc because broken dependencies are unacceptable.

First production use: RenovateAI - The AI that understands architecture.

"We don't wait for packages to work. We build." - Trial and Error Inc

Star this repo if you found it useful! We're building more MCP servers for the tools you actually use.

This server cannot be installed

-
security - not tested
F
license - not found
-
quality - not tested

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Enables AI assistants to access App Store Connect data including financial metrics, subscription analytics, app performance data, and revenue insights. Provides real-time iOS app metrics through secure API integration with rate limiting and comprehensive reporting capabilities.

  1. Problem
    1. Solution
      1. Quick Start
        1. Getting App Store Connect Credentials
          1. What You Can Ask Claude
            1. Architecture
              1. Project Structure
                1. Development
                  1. Why We Built This
                    1. Status
                      1. Completed ✅
                      2. In Progress 🔄
                      3. Roadmap 📍
                    2. License
                      1. Available Tools
                        1. Troubleshooting
                          1. Common Issues
                          2. Debug Mode
                          3. Verification Commands
                        2. Support
                          1. Credits

                            Related MCP Servers

                            • AppTweak MCP Server

                              -
                              security
                              F
                              license
                              -
                              quality
                              Enables app store analytics and competitor analysis through AppTweak API, with tools for keyword research, download estimates, and user review insights.

                            • Metabase MCP

                              hyeongjun-dev
                              -
                              security
                              F
                              license
                              -
                              quality
                              Connect AI assistants to your Metabase analytics platform. Access dashboards, execute queries, and retrieve data seamlessly through conversational interfaces. Enhance your analytics experience with structured data access and robust error handling.
                              Last updated -
                              21

                            • Apple MCP Tools

                              wearesage
                              A
                              security
                              F
                              license
                              A
                              quality
                              A collection of tools that enable AI assistants to interact with Apple applications and services including Contacts, Notes, Messages, Mail, Reminders, Calendar, Maps, and Web Search through the Model Context Protocol.
                              Last updated -
                              8
                              1
                              • Apple

                            • macOS Contacts MCP

                              jcontini
                              A
                              security
                              F
                              license
                              A
                              quality
                              Connects AI assistants to macOS Contacts app, allowing users to search, view, add, and update contacts through natural language conversations.
                              Last updated -
                              5
                              3
                              • Apple

                            View all related MCP servers

                            New MCP Servers

                            MCP directory API

                            We provide all the information about MCP servers via our MCP API.

                            curl -X GET 'https://glama.ai/api/mcp/v1/servers/TrialAndErrorAI/appstore-connect-mcp'

                            If you have feedback or need assistance with the MCP directory API, please join our Discord server