Skip to content
MCP server

Apple Ads

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

Runs locallyStatus and history
Install
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-mcp

Add 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.)Required
  • ASA_TEAM_IDApple Search Ads team ID (starts with SEARCHADS.)Required
  • ASA_KEY_IDApple Search Ads key ID (UUID)Required
  • ASA_PRIVATE_KEY_PATHAbsolute path to your PKCS#8 private key fileRequired
  • ASA_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