Apple Ads MCP Server

by happygalloio.github.Happygallo/apple-adsv1.0.3

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

7Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Stale7mo ago

Install Apple Ads MCP server

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

{
  "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 (global) or .cursor/mcp.json (project).

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

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "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 .vscode/mcp.json in your workspace.

{
  "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 ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
ASA_CLIENT_ID	yes	—	Apple Search Ads client ID (starts with SEARCHADS.)
ASA_TEAM_ID	yes	—	Apple Search Ads team ID (starts with SEARCHADS.)
ASA_KEY_ID	yes	—	Apple Search Ads key ID (UUID)
ASA_PRIVATE_KEY_PATH	yes	—	Absolute path to your PKCS#8 private key file
ASA_ORG_ID	—	—	Organization ID (optional, use list_organizations to switch at runtime)

Freshness

Stale — last maintenance signal 7mo ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-03-17 · 7mo ago · GitHub
Latest release
2026-03-17 · 7mo ago · GitHub · v1.0.3
Package published
no data · npm/PyPI
Registry entry updated
2026-03-17 · 7mo ago · official registry · v1.0.3

FAQ

›How do I install the Apple Ads MCP server 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. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Apple Ads require an API key?

Yes. It expects ASA_CLIENT_ID, ASA_TEAM_ID, ASA_KEY_ID, ASA_PRIVATE_KEY_PATH.

›Can I use Apple Ads as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Apple Ads in the official MCP registry?

Yes, as io.github.Happygallo/apple-ads.