apple-ads — Claude Code MCP server: what it does, how to install
This MCP server connects Apple Search Ads API v5 to an AI client for campaign, budget, keyword, and report operations.
claude mcp add --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> --env ASA_ORG_ID=<ASA_ORG_ID> --transport stdio apple-ads -- npx -y apple-ads-mcpWhat apple-ads does
apple-ads links an MCP client with Apple Search Ads API v5. It can create, edit, pause, and remove campaigns and ad groups, adjust bids, manage targeting and negative keywords, and work with creatives and budgets.
Its tools cover reports for campaigns, ad groups, keywords, ads, and geographic performance. It can also inspect the queries behind ad traffic, produce impression-share reports, and change the active organization during a session.
Setup requires the Apple API values ASA_CLIENT_ID, ASA_TEAM_ID, and ASA_KEY_ID, plus the path in ASA_PRIVATE_KEY_PATH. The server cannot connect without those credentials and a private key; an API user must use a different Apple ID from the account administrator.
What it helps with
- manage Apple Search Ads campaigns
- change keyword bids and exclusions
- review campaign and geo reports
- inspect queries that trigger ads
- switch between organizations
Example prompts for the agent
- Show campaign and ad-group results for the previous week.
- Pause the brand campaign and set the discovery budget to the requested amount.
- Find useful search queries and add the strongest ones as exact-match keywords.
How to install apple-ads
Platform CLI
claude mcp add --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> --env ASA_ORG_ID=<ASA_ORG_ID> --transport stdio apple-ads -- npx -y apple-ads-mcpReplace <…> with your own values
Platform CLI
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> --env ASA_ORG_ID=<ASA_ORG_ID> -- npx -y apple-ads-mcpReplace <…> with your own values
Config file
{
"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>"
}
}
}
}Replace <…> with your own values
Config file
{
"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>",
"ASA_ORG_ID": "<ASA_ORG_ID>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e ASA_CLIENT_ID=<ASA_CLIENT_ID> -e ASA_TEAM_ID=<ASA_TEAM_ID> -e ASA_KEY_ID=<ASA_KEY_ID> -e ASA_PRIVATE_KEY_PATH=<ASA_PRIVATE_KEY_PATH> -e ASA_ORG_ID=<ASA_ORG_ID> apple-ads npx -y apple-ads-mcpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about apple-ads
How do I install apple-ads in Claude Code?
Run `claude mcp add apple-ads -e ASA_CLIENT_ID=<ASA_CLIENT_ID> -e ASA_TEAM_ID=<ASA_TEAM_ID> -e ASA_KEY_ID=<ASA_KEY_ID> -e ASA_PRIVATE_KEY_PATH=<ASA_PRIVATE_KEY_PATH> -- npx -y apple-ads-mcp`.
What does apple-ads do?
It connects Claude Code and other MCP clients to Apple Search Ads API v5. The server handles campaigns, keywords, budgets, creatives, and performance reports.
What credentials does apple-ads need?
You need Apple Search Ads API identifiers and a PEM private key path. For several organizations, set ASA_ORG_ID or switch organizations at runtime.
