Skip to content
Back to search

app-store-connect-mcp-server

App Store Connect MCP Server

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/joshuarileydev--app-store-connect-mcp-server/badge.svg)](/listings/joshuarileydev--app-store-connect-mcp-server)

HTML

<a href="/listings/joshuarileydev--app-store-connect-mcp-server"><img src="/api/listings/joshuarileydev--app-store-connect-mcp-server/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Using Smithery

To install App Store Connect Server for Claude Desktop automatically:

npx @smithery/cli install appstore-connect-mcp-server --client claude

Manual Installation

npm install @joshuarileydev/app-store-connect-mcp-server

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 606 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # App Store Connect MCP Server
  2. A Model Context Protocol (MCP) server for interacting with the App Store Connect API. This server provides tools for managing apps, beta testers, bundle IDs, devices, app metadata, and capabilities in App Store Connect.
  3. [![Install MCP Server](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/install-mcp?name=app-store-connect&config=JTdCJTIyY29tbWFuZCUyMiUzQSUyMm5weCUyMC15JTIwYXBwc3RvcmUtY29ubmVjdC1tY3Atc2VydmVyJTIyJTdE)
  4. ## Overview
  5. The App Store Connect MCP Server is a comprehensive tool that bridges the gap between AI and Apple's App Store Connect ecosystem. Built on the Model Context Protocol (MCP), this server enables developers to interact with their App Store Connect data directly through conversational AI, making app management, beta testing, and analytics more accessible than ever.
  6. **Key Benefits:**
  7. - 🤖 **AI-Powered App Management**: Use natural language to manage your iOS and macOS apps
  8. - 📊 **Comprehensive Analytics**: Access detailed app performance, sales, and user engagement data
  9. - 👥 **Streamlined Beta Testing**: Efficiently manage beta groups and testers
  10. - 🌍 **Localization Management**: Update app descriptions, keywords, and metadata across all languages
  11. - 🔧 **Developer Tools Integration**: List Xcode project schemes and integrate with development workflows
  12. - 🔐 **Secure Authentication**: Uses official App Store Connect API with JWT authentication
  13. - 🚀 **Real-time Data**: Access up-to-date information directly from Apple's systems
  14. **Who This Is For:**
  15. - iOS/macOS developers managing apps in App Store Connect
  16. - Development teams coordinating beta testing programs
  17. - Product managers analyzing app performance and user engagement
  18. - Marketing teams managing app metadata and localizations
  19. - DevOps engineers automating app store workflows
  20. - Anyone looking to streamline their Apple developer experience
  21. This server transforms complex App Store Connect operations into simple conversational commands, whether you're checking app analytics, managing beta testers, updating app descriptions, or exploring your development pipeline.
  22. <a href="https://glama.ai/mcp/servers/z4j2smln34"><img width="380" height="200" src="https://glama.ai/mcp/servers/z4j2smln34/badge" alt="app-store-connect-mcp-server MCP server" /></a>
  23. <a href="https://smithery.ai/server/appstore-connect-mcp-server" style="text-decoration: none;">
  24. <img alt="Smithery Installations" src="https://smithery.ai/badge/appstore-connect-mcp-server" />
  25. </a>
  26. [![MseeP.ai Security Assessment Badge](https://mseep.net/pr/joshuarileydev-app-store-connect-mcp-server-badge.png)](https://mseep.ai/app/joshuarileydev-app-store-connect-mcp-server)
  27. ## Features
  28. - **App Management**
  29. - List all apps
  30. - Get detailed app information
  31. - View app metadata and relationships
  32. - **Beta Testing**
  33. - List beta groups
  34. - List beta testers
  35. - Add/remove testers from groups
  36. - Manage beta test configurations
  37. - View beta feedback with screenshots and device information
  38. - **App Store Version Localizations** ✨ **NEW**
  39. - Create new app store versions with release scheduling
  40. - List all app store versions for an app
  41. - List all localizations for an app version
  42. - Get specific localization details
  43. - Update app descriptions, keywords, and promotional text
  44. - Manage marketing and support URLs
  45. - Update "What's New" text for releases
  46. - **Bundle ID Management**
  47. - List bundle IDs
  48. - Create new bundle IDs
  49. - Get bundle ID details
  50. - Enable/disable capabilities
  51. - **Device Management**
  52. - List registered devices
  53. - Filter by device type, platform, status
  54. - View device details
  55. - **User Management**
  56. - List team members
  57. - View user roles and permissions
  58. - Filter users by role and access
  59. - **Analytics & Reports**
  60. - Create analytics report requests for apps
  61. - Download App Store engagement, commerce, and usage analytics
  62. - Access performance and frameworks usage reports
  63. - Download sales and trends reports (daily, weekly, monthly, yearly)
  64. - Download finance reports by region
  65. - **Xcode Development Tools**
  66. - List available schemes in Xcode projects and workspaces
  67. - Integrate with development workflows and CI/CD pipelines
  68. ## Installation
  69. ### Using Smithery
  70. To install App Store Connect Server for Claude Desktop automatically:
  71. ```bash
  72. npx @smithery/cli install appstore-connect-mcp-server --client claude
  73. ```
  74. ### Manual Installation
  75. ```bash
  76. npm install @joshuarileydev/app-store-connect-mcp-server
  77. ```
  78. ## Configuration
  79. Add the following to your Claude Desktop configuration file:
  80. ### macOS
  81. ```bash
  82. ~/Library/Application Support/Claude/claude_desktop_config.json
  83. ```
  84. ### Windows
  85. ```bash
  86. %APPDATA%\Claude\claude_desktop_config.json
  87. ```
  88. ```json
  89. {
  90. "mcpServers": {
  91. "app-store-connect": {
  92. "command": "npx",
  93. "args": [
  94. "-y",
  95. "appstore-connect-mcp-server"
  96. ],
  97. "env": {
  98. "APP_STORE_CONNECT_KEY_ID": "YOUR_KEY_ID",
  99. "APP_STORE_CONNECT_ISSUER_ID": "YOUR_ISSUER_ID",
  100. "APP_STORE_CONNECT_P8_PATH": "/path/to/your/auth-key.p8",
  101. "APP_STORE_CONNECT_VENDOR_NUMBER": "YOUR_VENDOR_NUMBER_OPTIONAL"
  102. }
  103. }
  104. }
  105. }
  106. ```
  107. ## Authentication
  108. ### Required Configuration
  109. 1. Generate an App Store Connect API Key from [App Store Connect](https://appstoreconnect.apple.com/access/integrations/api)
  110. 2. Download the .p8 private key file
  111. 3. Note your Key ID and Issuer ID
  112. 4. Set the required environment variables in your configuration:
  113. - `APP_STORE_CONNECT_KEY_ID`: Your API Key ID
  114. - `APP_STORE_CONNECT_ISSUER_ID`: Your Issuer ID
  115. - `APP_STORE_CONNECT_P8_PATH`: Path to your .p8 private key file
  116. ### Optional Configuration for Sales & Finance Reports
  117. To enable sales and finance reporting tools, you'll also need:
  118. - `APP_STORE_CONNECT_VENDOR_NUMBER`: Your vendor number from App Store Connect
  119. **Note**: Sales and finance report tools (`download_sales_report`, `download_finance_report`) will only be available if the vendor number is configured. You can find your vendor number in App Store Connect under "Sales and Trends" or "Payments and Financial Reports".
  120. ## Complete Tool Reference
  121. ### 📱 App Management Tools
  122. #### `list_apps`
  123. Get a list of all apps in App Store Connect.
  124. **Parameters:**
  125. - `limit` (optional): Maximum number of apps to return (default: 100, max: 200)
  126. - `bundleId` (optional): Filter by bundle identifier
  127. **Example:**
  128. ```
  129. "List all my apps"
  130. "Show me apps with bundle ID com.example.myapp"
  131. "Get the first 50 apps"
  132. ```
  133. #### `get_app_info`
  134. Get detailed information about a specific app.
  135. **Parameters:**
  136. - `appId` (required): The ID of the app
  137. - `include` (optional): Related resources to include (e.g., appClips, appInfos, appStoreVersions, betaGroups, builds)
  138. **Example:**
  139. ```
  140. "Get info for app ID 123456789"
  141. "Show me app 123456789 with beta groups and builds"
  142. "Get detailed information about my app including app store versions"
  143. ```
  144. ### 👥 Beta Testing Tools
  145. #### `list_beta_groups`
  146. List all beta testing groups (internal and external).
  147. **Parameters:**
  148. - `limit` (optional): Maximum number of groups to return (default: 100, max: 200)
  149. - `appId` (optional): Filter by app ID
  150. **Example:**
  151. ```
  152. "Show all beta groups"
  153. "List beta groups for app 123456789"
  154. "Get the first 20 beta groups"
  155. ```
  156. #### `list_group_testers`
  157. List testers in a specific beta group.
  158. **Parameters:**
  159. - `groupId` (required): The ID of the beta group
  160. - `limit` (optional): Maximum number of testers to return (default: 100, max: 200)
  161. **Example:**
  162. ```
  163. "List all testers in group ABC123"
  164. "Show me the first 50 testers in beta group ABC123"
  165. ```
  166. #### `add_tester_to_group`
  167. Add a new tester to a beta group.
  168. **Parameters:**
  169. - `groupId` (required): The ID of the beta group
  170. - `email` (required): Email address of the tester
  171. - `firstName` (optional): Tester's first name
  172. - `lastName` (optional): Tester's last name
  173. **Example:**
  174. ```
  175. "Add john@example.com to beta group ABC123"
  176. "Add John Smith (john@example.com) to group ABC123"
  177. ```
  178. #### `remove_tester_from_group`
  179. Remove a tester from a beta group.
  180. **Parameters:**
  181. - `groupId` (required): The ID of the beta group
  182. - `testerId` (required): The ID of the tester
  183. **Example:**
  184. ```
  185. "Remove tester XYZ789 from group ABC123"
  186. "Delete tester XYZ789 from beta group ABC123"
  187. ```
  188. #### `list_beta_feedback_screenshots`
  189. List beta feedback screenshot submissions.
  190. **Parameters:**
  191. - `appId` (optional): Filter by app ID
  192. - `bundleId` (optional): Filter by bundle identifier
  193. - `buildId` (optional): Filter by build ID
  194. - `limit` (optional): Maximum results (default: 100)
  195. - `includeBuilds` (optional): Include build information
  196. - `includeTesters` (optional): Include tester information
  197. **Example:**
  198. ```
  199. "Show beta feedback screenshots for app 123456789"
  200. "List feedback screenshots for bundle ID com.example.app"
  201. "Get feedback with tester info for build XYZ"
  202. ```
  203. #### `get_beta_feedback_screenshot`
  204. Get detailed information about a specific beta feedback screenshot.
  205. **Parameters:**
  206. - `feedbackId` (required): The ID of the feedback
  207. - `includeBuilds` (optional): Include build information
  208. - `includeTesters` (optional): Include tester information
  209. - `downloadScreenshot` (optional): Download the screenshot image (default: true)
  210. **Example:**
  211. ```
  212. "Get feedback screenshot FEEDBACK123"
  213. "Show me feedback FEEDBACK123 with tester details"
  214. "Download screenshot from feedback FEEDBACK123"
  215. ```
  216. ### 🌍 App Store Version Localization Tools
  217. #### `create_app_store_version`
  218. Create a new app store version for an app.
  219. **Parameters:**
  220. - `appId` (required): The ID of the app
  221. - `platform` (required): The platform (IOS, MAC_OS, TV_OS, VISION_OS)
  222. - `versionString` (required): Version string in format X.Y or X.Y.Z (e.g., '1.0' or '1.0.0')
  223. - `copyright` (optional): Copyright text for this version
  224. - `releaseType` (optional): How the app should be released (MANUAL, AFTER_APPROVAL, SCHEDULED)
  225. - `earliestReleaseDate` (optional): ISO 8601 date string (required when releaseType is SCHEDULED)
  226. - `buildId` (optional): ID of the build to associate with this version
  227. **Example:**
  228. ```
  229. "Create iOS version 2.0.0 for app 123456789"
  230. "Create macOS version 1.5.0 for app 123456789 with manual release"
  231. "Create scheduled iOS version 2.1.0 for app 123456789 releasing on 2024-02-01"
  232. "Create version 1.2.0 for app 123456789 with build BUILD456 and copyright '2024 My Company'"
  233. ```
  234. #### `list_app_store_versions`
  235. Get all app store versions for a specific app.
  236. **Parameters:**
  237. - `appId` (required): The ID of the app
  238. - `limit` (optional): Maximum number of versions to return (default: 100, max: 200)
  239. - `filter` (optional): Filter options
  240. - `platform`: Filter by platform (IOS, MAC_OS, TV_OS)
  241. - `versionString`: Filter by version string (e.g., '1.0.0')
  242. - `appStoreState`: Filter by state (e.g., READY_FOR_SALE, PREPARE_FOR_SUBMISSION)
  243. **Example:**
  244. ```
  245. "List all versions for app 123456789"
  246. "Show iOS versions for app 123456789"
  247. "Find version 2.0.0 for app 123456789"
  248. "List versions in review for app 123456789"
  249. ```
  250. #### `list_app_store_version_localizations`
  251. Get all localizations for a specific app store version.
  252. **Parameters:**
  253. - `appStoreVersionId` (required): The ID of the app store version
  254. - `limit` (optional): Maximum number of localizations (default: 100, max: 200)
  255. **Example:**
  256. ```
  257. "List all localizations for app version VERSION123"
  258. "Show me language versions for app store version VERSION123"
  259. ```
  260. #### `get_app_store_version_localization`
  261. Get detailed information about a specific localization.
  262. **Parameters:**
  263. - `localizationId` (required): The ID of the localization
  264. **Example:**
  265. ```
  266. "Get localization details for LOCALE123"
  267. "Show me the French localization LOCALE123"
  268. ```
  269. #### `update_app_store_version_localization`
  270. Update a specific field in an app store version localization.
  271. **Parameters:**
  272. - `localizationId` (required): The ID of the localization
  273. - `field` (required): Field to update (description, keywords, marketingUrl, promotionalText, supportUrl, whatsNew)
  274. - `value` (required): New value for the field
  275. **Example:**
  276. ```
  277. "Update description for localization LOCALE123 to 'Amazing new app description'"
  278. "Change keywords for LOCALE123 to 'productivity, tasks, organize'"
  279. "Update what's new text for LOCALE123 to 'Bug fixes and performance improvements'"
  280. ```
  281. ### 🔤 Bundle ID Management Tools
  282. #### `create_bundle_id`
  283. Register a new bundle ID for app development.
  284. **Parameters:**
  285. - `identifier` (required): The bundle ID string (e.g., 'com.example.app')
  286. - `name` (required): A name for the bundle ID
  287. - `platform` (required): Platform (IOS, MAC_OS, or UNIVERSAL)
  288. - `seedId` (optional): Your team's seed ID
  289. **Example:**
  290. ```
  291. "Create bundle ID com.mycompany.newapp for iOS named 'My New App'"
  292. "Register universal bundle ID com.example.app called 'Example App'"
  293. ```
  294. #### `list_bundle_ids`
  295. Find and list bundle IDs registered to your team.
  296. **Parameters:**
  297. - `limit` (optional): Maximum results (default: 100, max: 200)
  298. - `sort` (optional): Sort order (name, -name, platform, -platform, identifier, -identifier)
  299. - `filter` (optional): Filter by identifier, name, platform, or seedId
  300. - `include` (optional): Include related resources (profiles, bundleIdCapabilities, app)
  301. **Example:**
  302. ```
  303. "List all bundle IDs"
  304. "Show iOS bundle IDs sorted by name"
  305. "Find bundle IDs containing 'example'"
  306. ```
  307. #### `get_bundle_id_info`
  308. Get detailed information about a specific bundle ID.
  309. **Parameters:**
  310. - `bundleIdId` (required): The ID of the bundle ID
  311. - `include` (optional): Related resources to include
  312. - `fields` (optional): Specific fields to include
  313. **Example:**
  314. ```
  315. "Get info for bundle ID BUNDLE123"
  316. "Show bundle ID BUNDLE123 with capabilities"
  317. ```
  318. #### `enable_bundle_capability`
  319. Enable a capability for a bundle ID.
  320. **Parameters:**
  321. - `bundleIdId` (required): The ID of the bundle ID
  322. - `capabilityType` (required): Type of capability (e.g., PUSH_NOTIFICATIONS, ICLOUD, GAME_CENTER)
  323. - `settings` (optional): Capability-specific settings
  324. **Example:**
  325. ```
  326. "Enable push notifications for bundle ID BUNDLE123"
  327. "Add iCloud capability to bundle BUNDLE123"
  328. "Enable Game Center for bundle ID BUNDLE123"
  329. ```
  330. #### `disable_bundle_capability`
  331. Disable a capability for a bundle ID.
  332. **Parameters:**
  333. - `capabilityId` (required): The ID of the capability to disable
  334. **Example:**
  335. ```
  336. "Disable capability CAP123"
  337. "Remove capability CAP123 from bundle ID"
  338. ```
  339. ### 📱 Device Management Tools
  340. #### `list_devices`
  341. Get a list of all devices registered to your team.
  342. **Parameters:**
  343. - `limit` (optional): Maximum results (default: 100, max: 200)
  344. - `sort` (optional): Sort order (name, platform, status, udid, deviceClass, model, addedDate)
  345. - `filter` (optional): Filter by name, platform, status, udid, or deviceClass
  346. - `fields` (optional): Specific fields to include
  347. **Example:**
  348. ```
  349. "List all devices"
  350. "Show enabled iOS devices"
  351. "Find devices with name containing 'John'"
  352. "List iPhones sorted by date added"
  353. ```
  354. ### 👤 User Management Tools
  355. #### `list_users`
  356. Get a list of all users on your App Store Connect team.
  357. **Parameters:**
  358. - `limit` (optional): Maximum results (default: 100, max: 200)
  359. - `sort` (optional): Sort order (username, firstName, lastName, roles)
  360. - `filter` (optional): Filter by username or roles
  361. - `fields` (optional): Specific fields to include
  362. - `include` (optional): Include visibleApps relationship
  363. **Example:**
  364. ```
  365. "List all team members"
  366. "Show users with admin role"
  367. "Find developers sorted by last name"
  368. "List users with their visible apps"
  369. ```
  370. ### 📊 Analytics & Reports Tools
  371. #### `create_analytics_report_request`
  372. Create a new analytics report request for an app.
  373. **Parameters:**
  374. - `appId` (required): The app ID
  375. - `accessType` (required): Type of analytics (ONGOING or ONE_TIME_SNAPSHOT)
  376. - `frequency` (optional): Report frequency for ongoing reports (DAILY, WEEKLY, MONTHLY)
  377. - `startDate` (optional): Start date (YYYY-MM-DD)
  378. - `endDate` (optional): End date (YYYY-MM-DD)
  379. **Example:**
  380. ```
  381. "Create daily analytics report for app 123456789"
  382. "Generate one-time snapshot report for app 123456789 from 2024-01-01 to 2024-01-31"
  383. ```
  384. #### `list_analytics_reports`
  385. Get available analytics reports for a request.
  386. **Parameters:**
  387. - `reportRequestId` (required): The report request ID
  388. - `limit` (optional): Maximum results (default: 100, max: 200)
  389. - `filter` (optional): Filter by category, name, or date
  390. **Example:**
  391. ```
  392. "List reports for request REQ123"
  393. "Show app usage reports for request REQ123"
  394. ```
  395. #### `list_analytics_report_segments`
  396. Get segments for a specific analytics report.
  397. **Parameters:**
  398. - `reportId` (required): The analytics report ID
  399. - `limit` (optional): Maximum results (default: 100, max: 200)
  400. **Example:**
  401. ```
  402. "List segments for report REPORT123"
  403. "Get download URLs for report REPORT123"
  404. ```
  405. #### `download_analytics_report_segment`
  406. Download data from an analytics report segment.
  407. **Parameters:**
  408. - `url` (required): The segment download URL
  409. **Example:**
  410. ```
  411. "Download data from https://api.appstoreconnect.apple.com/..."
  412. ```
  413. ### 💰 Sales & Finance Reports Tools (Requires Vendor Number)
  414. #### `download_sales_report`
  415. Download sales and trends reports.
  416. **Parameters:**
  417. - `frequency` (required): Report frequency (DAILY, WEEKLY, MONTHLY, YEARLY)
  418. - `reportDate` (required): Date in appropriate format
  419. - `reportType` (required): Type of report (SALES, SUBSCRIPTION, SUBSCRIPTION_EVENT, SUBSCRIBER, NEWSSTAND, PREORDER)
  420. - `reportSubType` (required): SUMMARY or DETAILED
  421. - `vendorNumber` (optional): Override default vendor number
  422. - `version` (optional): Report version (default: 1_0)
  423. **Example:**
  424. ```
  425. "Download daily sales summary for 2024-01-15"
  426. "Get monthly subscription detailed report for 2024-01"
  427. "Download yearly sales summary for 2023"
  428. ```
  429. #### `download_finance_report`
  430. Download finance reports for a specific region.
  431. **Parameters:**
  432. - `reportDate` (required): Report date (YYYY-MM)
  433. - `regionCode` (required): Region code (e.g., 'Z1' for worldwide)
  434. - `vendorNumber` (optional): Override default vendor number
  435. **Example:**
  436. ```
  437. "Download finance report for January 2024 worldwide"
  438. "Get finance report for 2024-01 region Z1"
  439. ```
  440. ### 🔧 Xcode Development Tools
  441. #### `list_schemes`
  442. List all available schemes in an Xcode project or workspace.
  443. **Parameters:**
  444. - `projectPath` (required): Path to .xcodeproj or .xcworkspace file
  445. **Example:**
  446. ```
  447. "List schemes in /Users/john/MyApp/MyApp.xcodeproj"
  448. "Show available schemes for MyApp.xcworkspace"
  449. ```
  450. ## Error Handling
  451. The server implements proper error handling for:
  452. - Invalid authentication
  453. - Missing required parameters
  454. - API rate limits
  455. - Network issues
  456. - Invalid operations
  457. ## Development
  458. ```bash
  459. # Install dependencies
  460. npm install
  461. # Build the project
  462. npm run build
  463. # Run tests
  464. npm test
  465. # Run type checking
  466. npm run type-check
  467. ```
  468. ## License
  469. This project is licensed under the MIT License - see the LICENSE file for details.
  470. ## Related Links
  471. - [Model Context Protocol Documentation](https://modelcontextprotocol.io)
  472. - [App Store Connect API Documentation](https://developer.apple.com/documentation/appstoreconnectapi)
  473. - [MCP TypeScript SDK](https://github.com/modelcontextprotocol/typescript-sdk)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.