MCP server for App Store Connect & Play Console API

Up-to-date ASO workflows exposed as MCP tools. Run it as a stdio MCP server (Claude Code, Cursor, MCP Inspector, etc.) to manage metadata, releases, and store syncs without leaving your AI client.

[!NOTE] Runs 100% locally on your machine, so credentials and cached ASO data never leave your environment (store API calls are made directly from your device).

<br>

Without pabal-mcp

• Manual App Store Connect and Google Play Console clicks for every update
• Copy-paste errors across locales and release notes
• Repeating the same setup per client or project

<br>

With pabal-mcp

• One MCP server that handles ASO pulls/pushes for both stores
• Consistent release note updates and version checks from your AI client
• Reusable, scriptable workflows backed by local cache and config

<br>

MCP Client Installation

Requirements

• Node.js >= 18
• MCP client: Cursor, Claude Code, VS Code, Windsurf, etc.

[!TIP] If you repeatedly do ASO/store tasks, add a client rule like "always use pabal-mcp" so the MCP server auto-invokes without typing it every time.

Global install (recommended)

npm install -g pabal-mcp
# or
yarn global add pabal-mcp

Install globally first for fastest starts and to avoid npm download issues (proxy/firewall/offline). You can still use npx -y pabal-mcp, but global install is recommended. After global install, set your MCP config to command: "pabal-mcp" (no npx needed).

<details> <summary><b>Install in Cursor</b></summary>

Add to ~/.cursor/mcp.json (global) or project .cursor/mcp.json:

{
  "mcpServers": {
    "pabal-mcp": {
      "command": "npx",
      "args": ["-y", "pabal-mcp"]
    }
  }
}

</details> <details> <summary><b>Install in VS Code</b></summary>

Example settings.json MCP section:

"mcp": {
  "servers": {
    "pabal-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "pabal-mcp"]
    }
  }
}

</details> <details> <summary><b>Install in Claude Code</b></summary>

[!TIP] See the official Claude Code MCP documentation for detailed configuration options.

Add to Claude Code MCP settings (JSON format):

{
  "mcpServers": {
    "pabal-mcp": {
      "command": "npx",
      "args": ["-y", "pabal-mcp"]
    }
  }
}

Or if installed globally (npm install -g pabal-mcp):

{
  "mcpServers": {
    "pabal-mcp": {
      "command": "pabal-mcp"
    }
  }
}

</details> <details> <summary><b>Install in Windsurf</b></summary>

{
  "mcpServers": {
    "pabal-mcp": {
      "command": "npx",
      "args": ["-y", "pabal-mcp"]
    }
  }
}

</details> <br>

Configure Credentials

1. Create config directory and set permissions:

mkdir -p ~/.config/pabal-mcp
chmod 700 ~/.config/pabal-mcp

1. Create the config file (pre-filled placeholders):

cat <<'EOF' > ~/.config/pabal-mcp/config.json
{
  "dataDir": "/ABSOLUTE/PATH/TO/pabal-web",
  "appStore": {
    "issuerId": "xxxx",
    "keyId": "xxxx",
    "privateKeyPath": "./app-store-key.p8"
  },
  "googlePlay": {
    "serviceAccountKeyPath": "./google-play-service-account.json"
  }
}
EOF

Replace the issuerId and keyId placeholders in the next step after you grab your App Store Connect keys. dataDir is the absolute path where raw data pulled from each store is stored (e.g., /ABSOLUTE/PATH/TO/pabal-web).

1. Add your credentials to ~/.config/pabal-mcp/:

   App Store Connect API key:

   • App Store Connect > Users and Access > Keys "Generate API Key." Use Admin/App Manager, download the .p8 (only downloadable once), and save it as ~/.config/pabal-mcp/app-store-key.p8.
   • Copy the Issuer ID and Key ID from the key details, then update issuerId and keyId in ~/.config/pabal-mcp/config.json with those values.

   Google Play service account JSON:

   • Google Cloud Manage service accounts create a service account (name it pabal for clarity) Create key JSON.
   • Save the downloaded JSON as ~/.config/pabal-mcp/google-play-service-account.json.
   • Grant Play Console access to that service account email: go to Users and permissions Invite new user enter the service account email choose the ASO apps enable:
     • View app information and download bulk reports (read-only)
     • Create, edit, and delete drafts of apps
     • Release to production
     • Manage device exclusion lists
     • Use Play App Signing
     • Manage store presence

   Config file shape (after updating your IDs):

   {
     "dataDir": "/ABSOLUTE/PATH/TO/pabal-web",
     "appStore": {
       "issuerId": "<your-issuer-id>",
       "keyId": "<your-key-id>",
       "privateKeyPath": "./app-store-key.p8"
     },
     "googlePlay": {
       "serviceAccountKeyPath": "./google-play-service-account.json"
     }
   }
   

2. Pull store data

   Use apps-init to fetch and auto-register existing apps from the store APIs. This will populate your ~/.config/pabal-mcp/registered-apps.json with the apps available in your stores.

3. Lock file permissions (all files in the config folder):

chmod 600 ~/.config/pabal-mcp/*

This applies to every file under ~/.config/pabal-mcp/; rerun after adding any new credential file.

<br>

MCP Tools

• Authentication
  • auth-check: Check App…