MCP Apple Store Server provides AI assistants (like Claude) with direct access to Apple's APIs through the Model Context Protocol. Manage your iOS/macOS apps, subscriptions, TestFlight, provisioning profiles, and more - all through natural language commands.

• 83+ MCP Tools covering both App Store Server API and App Store Connect API
• Full CRUD Operations for apps, subscriptions, IAPs, and more
• Real-time Data access to transactions, reviews, analytics
• Secure Authentication using Apple's JWT-based auth
• Rate Limiting built-in to respect Apple's API limits
• Type-Safe complete TypeScript implementation with Zod validation

• Transaction history and verification
• Subscription status management
• Refund history lookup
• Order lookups
• Consumption information
• Server notifications (webhooks)

• Node.js 18+
• Apple Developer Program membership
• App Store Connect API Key (with appropriate permissions)

# Clone the repository
git clone https://github.com/AreDesX/mcp-apple-store.git
cd mcp-apple-store

# Install dependencies
npm install

# Run interactive setup wizard
npm run setup

# Build the project
npm run build

The setup wizard will guide you through:

1. API Key Creation - Step-by-step instructions to create your key in App Store Connect
2. Credential Configuration - Automatically configures your .env file
3. App Selection - Choose which app to manage
4. MCP Client Setup - Configures Claude Desktop or other MCP clients

npm run setup

Create a .env file with your credentials:

# Required: App Store Connect API credentials
APP_STORE_ISSUER_ID=your-issuer-id
APP_STORE_KEY_ID=your-key-id
APP_STORE_PRIVATE_KEY_PATH=./keys/AuthKey_XXXXXXXX.p8

# Required: Your app identifiers
APP_BUNDLE_ID=com.yourcompany.yourapp
APP_APPLE_ID=1234567890

# Optional: Environment (Production or Sandbox)
APP_STORE_ENVIRONMENT=Sandbox

Add to your claude_desktop_config.json:

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

{
  "mcpServers": {
    "apple-store": {
      "command": "node",
      "args": ["/path/to/mcp-apple-store/dist/index.js"],
      "env": {
        "APP_STORE_ISSUER_ID": "your-issuer-id",
        "APP_STORE_KEY_ID": "your-key-id",
        "APP_STORE_PRIVATE_KEY_PATH": "/path/to/AuthKey.p8",
        "APP_BUNDLE_ID": "com.yourcompany.yourapp",
        "APP_APPLE_ID": "1234567890",
        "APP_STORE_ENVIRONMENT": "Sandbox"
      }
    }
  }
}

Add to your MCP settings:

{
  "mcpServers": {
    "apple-store": {
      "command": "node",
      "args": ["dist/index.js"],
      "cwd": "/path/to/mcp-apple-store",
      "env": {
        "APP_STORE_ISSUER_ID": "your-issuer-id",
        "APP_STORE_KEY_ID": "your-key-id",
        "APP_STORE_PRIVATE_KEY_PATH": "./keys/AuthKey.p8",
        "APP_BUNDLE_ID": "com.yourcompany.yourapp",
        "APP_APPLE_ID": "1234567890"
      }
    }
  }
}

"List all my apps in App Store Connect"

"Create a subscription group called 'Premium' for app 6755709202"

"Create a monthly subscription called 'Premium Monthly' with product ID 'com.app.premium_monthly' in subscription group 21841364"

"Check if the subscription with transaction ID 123456789 is active"

"Get sales report for the last 7 days"

"Register my iPhone with UDID 00008101-001234567890001E as 'Dev iPhone 15'"

"List unanswered reviews for my app and respond to the most recent one-star review"

"Submit version 1.0 of my app for App Store review"

mcp-apple-store/
├── src/
│   ├── api/
│   │   ├── connect/           # App Store Connect API
│   │   │   ├── client.ts      # Connect API client
│   │   │   ├── apps-api.ts
│   │   │   ├── iap-api.ts
│   │   │   ├── testflight-api.ts
│   │   │   ├── provisioning-api.ts
│   │   │   ├── users-api.ts
│   │   │   ├── reviews-api.ts
│   │   │   ├── analytics-api.ts
│   │   │   ├── events-api.ts
│   │   │   ├── submission-api.ts
│   │   │   └── types/
│   │   ├── client.ts          # Server API client
│   │   ├── subscriptions.ts
│   │   └── transactions.ts
│   ├── auth/
│   │   ├── jwt-generator.ts   # Server API JWT
│   │   └── connect-jwt.ts     # Connect API JWT
│   ├── tools/
│   │   ├── connect/           # Connect API MCP tools
│   │   │   ├── apps-tools.ts
│   │   │   ├── iap-tools.ts
│   │   │   ├── testflight-tools.ts
│   │   │   ├── provisioning-tools.ts
│   │   │   ├── users-tools.ts
│   │   │   ├── reviews-tools.ts
│   │   │   ├── analytics-tools.ts
│   │   │   ├── events-tools.ts
│   │   │   └── submission-tools.ts
│   │   ├── subscription-tools.ts
│   │   └── transaction-tools.ts
│   ├── utils/
│   │   ├── rate-limiter.ts
│   │   └── pagination.ts
│   ├── webhooks/              # Server notification handlers
│   │   ├── handler.ts
│   │   ├── verifier.ts
│   │   └── types.ts
│   ├── config.ts
│   ├── server.ts              # MCP server
│   └── index.ts
├── keys/                      # API keys (gitignored)
├── scripts/
│   └── setup-credentials.ts   # Setup wizard
├── package.json
└── tsconfig.json

Server API JWT (with bundleId):

{
  iss: issuerId,
  iat: timestamp,
  exp: timestamp + 1200,
  aud: 'appstoreconnect-v1',
  bid: bundleId  // Required for Server API
}

Connect API JWT (without bundleId):

{
  iss: issuerId,
  iat: timestamp,
  exp: timestamp + 1200,
  aud: 'appstoreconnect-v1'
  // No 'bid' claim
}

npm run build

npm run dev

npm run typecheck

npm test
npm run test:run
npm run test:coverage

npm run lint

• Never commit your API keys - The keys/ directory is gitignored
• Use environment variables - Store credentials in .env (also gitignored)
• Minimum permissions - Create API keys with only the permissions you need
• Rotate keys regularly - Especially for production environments

This error typically means the API URL is malformed. Make sure you're using the latest version with the URL building fix.

Apple restricts app creation via API for some accounts. Create apps manually in App Store Connect, then use the API for everything else.

The server includes built-in rate limiting (3600 requests/hour for Connect API). If you hit limits, the server will automatically retry with exponential backoff.

• Verify your Issuer ID is correct (found in App Store Connect > Users and Access > Integrations > Keys)
• Ensure your Key ID matches the downloaded .p8 file
• Check that the private key file path is correct and readable

Make sure you're either:

1. Using the .env file in the project root
2. Passing environment variables through your MCP client configuration

Contributions are welcome! Please read our Contributing Guide for details.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

• App Store Pricing API support
• Subscription offer codes management
• Promotional offers
• Game Center integration
• App Clips management
• Custom Product Pages

This project is licensed under the MIT License - see the LICENSE file for details.

• Model Context Protocol - The protocol that makes this possible
• Apple App Store Server Library - Official Apple library
• Anthropic - For Claude and the MCP ecosystem

• Issues: GitHub Issues
• Discussions: GitHub Discussions