apple-ads

Name: apple-ads
Author: Happygallo

Happygallo

Get started Repository

MCP server for Apple Search Ads API v5 — manage campaigns, keywords, budgets, and reports through AI assistants

Setup

Choose your client, copy the config, then fill in any required environment variables.

Add to Cursor Add to VS Code

claude mcp add apple-ads --env ASA_CLIENT_ID='<ASA_CLIENT_ID>' --env ASA_TEAM_ID='<ASA_TEAM_ID>' --env ASA_KEY_ID='<ASA_KEY_ID>' --env ASA_PRIVATE_KEY_PATH='<ASA_PRIVATE_KEY_PATH>' -- npx -y apple-ads-mcp

~/.codex/config.toml

[mcp_servers.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>" }

# codex mcp add apple-ads --env ASA_CLIENT_ID='<ASA_CLIENT_ID>' --env ASA_TEAM_ID='<ASA_TEAM_ID>' --env ASA_KEY_ID='<ASA_KEY_ID>' --env ASA_PRIVATE_KEY_PATH='<ASA_PRIVATE_KEY_PATH>' -- npx -y apple-ads-mcp

~/.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>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "apple-ads": {
      "type": "stdio",
      "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>"
      }
    }
  }
}

~/.gemini/settings.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>"
      }
    }
  }
}

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>"
      }
    }
  }
}

.trae/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>"
      }
    }
  }
}

Environment variables

ASA_CLIENT_ID
ASA_TEAM_ID
ASA_KEY_ID
ASA_PRIVATE_KEY_PATH

Replace the placeholders with your own credentials and keep them out of version control.

Setup

Environment variables

Related