MCP server
Apple Ads
Manage Apple Search Ads campaigns, keywords, budgets, and reports via API v5.
Runs locallyStatus and history
- Pricing
- Open source
- Runs
- Locally
- Version
- 1.0.3
- Listing updated
- 5 days ago
About Apple Ads
Apple Ads is an open-source MCP server. It runs locally on your machine and is started by your AI client.
Install
Run in a terminal
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-mcpAdd to 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>"
}
}
}
}Add to ~/.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>"
}
}
}
}Add to .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>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_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>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"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>"
}
}
}
}Configuration
ASA_CLIENT_IDApple Search Ads client ID (starts with SEARCHADS.)RequiredASA_TEAM_IDApple Search Ads team ID (starts with SEARCHADS.)RequiredASA_KEY_IDApple Search Ads key ID (UUID)RequiredASA_PRIVATE_KEY_PATHAbsolute path to your PKCS#8 private key fileRequiredASA_ORG_IDOrganization ID (optional, use list_organizations to switch at runtime)
Pricing
Open source
Apple Ads FAQ
Is Apple Ads free?
Yes. Apple Ads is open source, so you can use and self-host it for free.
How do I add Apple Ads to Claude Code?
Run this command in your terminal: 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