← Index

io.github.Happygallo/apple-ads

io.github.Happygallo/apple-ads·v1.0.3·Documents & Spreadsheets
Quality Score
84
/100

Manage Apple Search Ads campaigns, keywords, budgets, and reports via API v5.

§01  Install
Claude Desktop (claude_desktop_config.json)
{
  "mcpServers": {
    "apple-ads": {
      "command": "npx",
      "args": [
        "-y",
        "apple-ads-mcp"
      ],
      "env": {
        "ASA_CLIENT_ID": "<asa_client_id>",
        "ASA_TEAM_ID": "<asa_team_id>",
        "ASA_KEY_ID": "<asa_key_id>",
        "ASA_PRIVATE_KEY_PATH": "<asa_private_key_path>",
        "ASA_ORG_ID": "<asa_org_id>"
      }
    }
  }
}
Cursor (.cursor/mcp.json)
{
  "mcpServers": {
    "apple-ads": {
      "command": "npx",
      "args": [
        "-y",
        "apple-ads-mcp"
      ],
      "env": {
        "ASA_CLIENT_ID": "<asa_client_id>",
        "ASA_TEAM_ID": "<asa_team_id>",
        "ASA_KEY_ID": "<asa_key_id>",
        "ASA_PRIVATE_KEY_PATH": "<asa_private_key_path>",
        "ASA_ORG_ID": "<asa_org_id>"
      }
    }
  }
}
Cline (cline_mcp_settings.json)
npx -y apple-ads-mcp
§02  Environment variables
ASA_CLIENT_ID
required

Apple Search Ads client ID (starts with SEARCHADS.)

ASA_TEAM_ID
required

Apple Search Ads team ID (starts with SEARCHADS.)

ASA_KEY_ID
required

Apple Search Ads key ID (UUID)

ASA_PRIVATE_KEY_PATH
required

Absolute path to your PKCS#8 private key file

ASA_ORG_ID

Organization ID (optional, use list_organizations to switch at runtime)

§03  MCP Quality Score  ·  methodology
freshness
24
completeness
10
installability
25
documentation
15
stability
10
§04  Alternatives in Documents & Spreadsheets