# Apple Ads MCP

> Apple Ads MCP is an open-source MCP server for marketing and seo. Local Go MCP server for researching and operating Apple Ads App Store campaigns. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** macOS, Linux, CLI, self-hosted
- **Repository:** https://github.com/zelentsov-dev/apple-ads-mcp
- **MCP Registry name:** io.github.zelentsov-dev/apple-ads-mcp
- **Categories:** [marketing and SEO](https://ai-powered.com/categories/marketing-and-seo)
- **Listing updated:** 2026-11-18

## About

Writes are the sensitive part of ad management, and this server is built around that. It starts read-only; a change only goes through when the Apple API user has a write role, the server runs with --allow-writes, the profile enables writes, a preview tool has validated the payload, and an unexpired single-use receipt is applied against unchanged inventory. Receipts expire after ten minutes, and the README says there is no background scheduler, so spend is never changed on its own.

It targets Apple Ads Platform API v1 and covers four placements: Search Results, Search Tab, Today Tab and Product Pages. Tools span account health, app eligibility, campaign and keyword inventory, keyword and target-CPA research, typed reports, bulk keyword edits, shared budgets and named local optimization policies with 28-day baselines. It has no raw-request tool and does not support the legacy Campaign Management API v5.

Credentials stay on the local machine and every account call names an explicit profile and ad account. It is independent open-source software and not affiliated with Apple.

## Features

- **Receipt-gated writes:** Every mutation needs a preview and a short-lived single-use receipt before it applies.
- **Read-only by default:** Sessions can audit and plan without any ability to change spend.
- **Keyword research:** Provides keyword, phrase and category suggestions, search popularity and impression share.
- **Typed reports:** Campaign, ad-group, ad, keyword and search-term reports with bounded pagination.
- **Optimization policies:** Named local policies and 28-day baselines drive plans that are verified item by item.
- **Local credentials:** Private keys stay on the user's machine and are referenced by path.

## Good for

- Audit the structure of an Apple Ads account without changing it
- Find keyword opportunities and separate Apple data from model inference
- Bulk-create negative keywords with a previewed, verified change
- Check which apps and placements an ad account is eligible for

## Install

### Claude Code (Terminal)

```sh
claude mcp add apple-ads-mcp --env APPLE_ADS_MCP_CONFIG='<APPLE_ADS_MCP_CONFIG>' -- docker run -i --rm -e APPLE_ADS_MCP_CONFIG ghcr.io/zelentsov-dev/apple-ads-mcp:v0.3.8
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "apple-ads-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "APPLE_ADS_MCP_CONFIG",
        "ghcr.io/zelentsov-dev/apple-ads-mcp:v0.3.8"
      ],
      "env": {
        "APPLE_ADS_MCP_CONFIG": "<APPLE_ADS_MCP_CONFIG>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "apple-ads-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "APPLE_ADS_MCP_CONFIG",
        "ghcr.io/zelentsov-dev/apple-ads-mcp:v0.3.8"
      ],
      "env": {
        "APPLE_ADS_MCP_CONFIG": "<APPLE_ADS_MCP_CONFIG>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "apple-ads-mcp": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "APPLE_ADS_MCP_CONFIG",
        "ghcr.io/zelentsov-dev/apple-ads-mcp:v0.3.8"
      ],
      "env": {
        "APPLE_ADS_MCP_CONFIG": "<APPLE_ADS_MCP_CONFIG>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "apple-ads-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "APPLE_ADS_MCP_CONFIG",
        "ghcr.io/zelentsov-dev/apple-ads-mcp:v0.3.8"
      ],
      "env": {
        "APPLE_ADS_MCP_CONFIG": "<APPLE_ADS_MCP_CONFIG>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "apple-ads-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "APPLE_ADS_MCP_CONFIG",
        "ghcr.io/zelentsov-dev/apple-ads-mcp:v0.3.8"
      ],
      "env": {
        "APPLE_ADS_MCP_CONFIG": "<APPLE_ADS_MCP_CONFIG>"
      }
    }
  }
}
```

## Tools

- `server_info`: Reports the server's version and capabilities.
- `account_health`: Checks readiness and health for a named profile, ad account and app.
- `apps_eligibility`: Reports whether an app is eligible to advertise.
- `campaigns_query`: Lists campaigns for an ad account.
- `keywords_query`: Lists targeting keywords.
- `operations_apply`: Applies a previewed change using its receipt.
- `operations_verify`: Verifies the outcome of an applied change.

## FAQ

### How do I install it?

The README gives a Homebrew install, brew install zelentsov-dev/tap/apple-ads-mcp, and an OCI image is also listed in the registry entry.

### Can it change my campaigns by accident?

Writes require several gates, including the --allow-writes flag, a write-enabled profile and a fresh receipt.

### Does it run optimization automatically?

No. The README says it has no scheduler and never changes spend in the background.

### Is it made by Apple?

No. It is independent and states it is not affiliated with or endorsed by Apple.

### Is Apple Ads MCP free?

Yes. Apple Ads MCP is open source, so you can use and self-host it for free.

### How do I add Apple Ads MCP to Claude Code?

Run this command in your terminal: claude mcp add apple-ads-mcp --env APPLE_ADS_MCP_CONFIG='<APPLE_ADS_MCP_CONFIG>' -- docker run -i --rm -e APPLE_ADS_MCP_CONFIG ghcr.io/zelentsov-dev/apple-ads-mcp:v0.3.8

### What are the best alternatives to Apple Ads MCP?

The closest alternatives to Apple Ads MCP are Google Ads + Meta Ads + SEO/GEO MCP, Calven, Customer Io, Google_search_console and Ads AI Creator MCP.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Calven](https://ai-powered.com/mcp/calven): Calven is an MCP server for marketing and seo.
- [Customer Io](https://ai-powered.com/mcp/customer-io): Customer Io is a freemium MCP server for marketing and seo.
- [Google_search_console](https://ai-powered.com/mcp/google-search-console-8): Google_search_console is a freemium MCP server for web search and scraping.
- [Ads AI Creator MCP](https://ai-powered.com/mcp/ads-ai-creator-mcp): Ads AI Creator MCP is a paid MCP server for marketing and seo.
- [Zovo QR Code Maker](https://ai-powered.com/mcp/zovo-qr-code-maker): Zovo QR Code Maker is an MCP server for marketing and seo.
- [Agentzia](https://ai-powered.com/mcp/agentzia): Agentzia is a freemium MCP server for marketing and seo.
- [Email Spam Tester](https://ai-powered.com/mcp/email-spam-tester): Email Spam Tester is a free MCP server for communication.

---
Source: https://ai-powered.com/mcp/apple-ads-mcp
