Apple Ads connector for Claude: keywords, CPA

Campaign name	Spend	Installs	Avg CPA
Search – Brand	$310	337	$0.92
Search – Competitors	$540	236	$2.29
Search – Category	$460	271	$1.70
Search – Discovery	$380	118	$3.22

01Setup

How to connect Apple Ads to Claude

Porter’s Apple Ads connector for Claude takes 3 steps, with no code or server. Connect your Apple Ads organization in Porter, add one MCP URL to Claude as a custom connector, then ask. The Apple Ads to Claude setup guide covers Claude Code. MCP (Model Context Protocol) is the open standard Claude uses to connect to tools.

What you need first

Before you start, you need an Apple Ads Advanced account and an API user invited by an account admin. You also need a free Porter account and any Claude plan. Under Apple’s Apple Ads user roles, API Account Manager gets read and write access, while API Account Read Only gets reporting access. If you want Claude to make changes, you need the first role.
Custom connectors work in Claude, Cowork and Claude Desktop on Free, Pro, Max, Team and Enterprise plans. However, Free allows only one (Anthropic’s guide to custom connectors). Porter’s guide also covers Claude Code.

Step 1: Connect Apple Ads in Porter
Sign up free at Porter, then pick Apple Ads as the source and enter your API user’s credentials. Pick the organization Claude should read, then pick Claude as the destination.
Step 2: Add the Apple Ads connector to Claude
In Claude, select “+” → Connectors → Manage connectors → “+” → Add custom connector. Then name it Porter Metrics, paste this URL and select Add:
MCP URL
https://mcp.portermetrics.com/mcp
Step 3: Ask Claude about Apple Ads
Sign in with your Porter account when Claude asks, then paste this prompt:
Prompt
List my Apple Ads organizations and show Spend, Taps, Installs (Total) and Avg CPA (Total) by Campaign Name for the last 7 full days.

Guides and videos

Watch the full Apple Ads to Claude setup in the video on this page (1:22)
See all 120+ Apple Ads fields with labels and IDs
More Claude setups on Porter’s YouTube channel

app.portermetrics.com / create

Porter's Connect a new data source list with Apple Ads ready to connect — First, find Apple Ads in Porter and select Connect.

Porter's Apple Ads authorization form with the public key and Client ID, Team ID and Key ID fields — Then copy Porter's public key into Apple Ads and paste the three IDs it gives you.

Claude's Add custom connector window with the name Porter Metrics and Porter's MCP URL filled in — Then, in Claude, add a custom connector with Porter's MCP URL.

Porter's Application Access Request screen asking you to let Claude use the Porter MCP server — When Claude asks, sign in to Porter and select Allow Access.

Porter Metrics listed as a connected connector in Claude with its read-only tools — After that, Porter shows as connected, so you can ask your first question.

If you prefer video, watch the whole Apple Ads to Claude setup (1:22, no sound).

Interactive walkthrough, so you can click along here

02Use cases and prompts

What you can ask Claude

Here are 8 things to try. Each use case comes with a prompt to copy, the fields it uses from the Apple Ads fields list and who it’s for. Every prompt asks about one level at a time (campaigns, ad groups, keywords, search terms or ads), because that’s how Apple Ads reports.

Can Claude find the Apple Ads keywords that bring installs at the lowest CPA?

Your keyword review starts from a ranked list instead of an export, and spend without installs stops hiding in the long tail.

Prompt

For the last 30 days, by Keyword, Match Type and Ad Group Name (Keyword), show Keyword Bid Amount, Spend, Impressions, Taps, TTR, Avg CPT, Installs (Total) and Avg CPA (Total). Rank the 20 keywords with the most Spend by Avg CPA (Total) and list keywords with more than $50 Spend and 0 Installs (Total).

For: app developers and founders · in-house UA managers · agencies (one organization per question; add App Name for multi-app accounts)

Fields used: KeywordMatch TypeAd Group Name (Keyword)Keyword Bid AmountSpendImpressionsTapsTTRAvg CPTInstalls (Total)Avg CPA (Total)

Can Claude turn search terms into exact-match keywords and negatives?

Your weekly search-term harvest becomes one prompt, and the new keywords and negatives also go in from the same chat.

Prompt

For the last 30 days, by Search Term, Search Term Source, Keyword (Search Term), Match Type (Search Term) and Ad Group Name (Search Term), show Spend, Taps, Installs (Total) and Avg CPA (Total). Leave out the row with an empty Search Term. List terms with Avg CPA (Total) under $3 and at least 5 installs that aren't exact keywords yet, and terms with 20+ Taps and 0 installs.

Then ask

Prompt

Add the first list as exact-match keywords in the same ad group at $1.20, and the second list as exact negatives on the campaign. Show me each one before you add it.

For: in-house UA managers · agencies · app developers

Fields used: Search TermSearch Term SourceKeyword (Search Term)Match Type (Search Term)Ad Group Name (Search Term)SpendTapsInstalls (Total)Avg CPA (Total)

Actions: keyword_create · negativekeyword_create

Can Claude tell if Search Match is worth the spend?

You decide on Search Match per ad group from CPA and conversion rate instead of a hunch.

Prompt

For the last 30 days, by Ad Group Name and Search Match, show Default Bid Amount, Spend, Taps, Installs (Total), Avg CPA (Total) and CR (Total). Compare the totals for Search Match on vs off and list ad groups with Search Match on whose Avg CPA (Total) is 30% above the account average.

Then ask

Prompt

Turn Search Match off on those ad groups. List them first and wait for my OK.

For: in-house UA managers · agencies

Fields used: Ad Group NameSearch MatchDefault Bid AmountSpendTapsInstalls (Total)Avg CPA (Total)CR (Total)

Action: adgroup_update

Are installs new users or redownloads, from taps or views?

You get a cost for new users only, since that’s the number worth setting CPA goals against.

Prompt

For the last 30 days, by Campaign Name, show Spend, Installs (Tap-Through), Installs (View-Through), Installs (Total), New Downloads (Total) and Redownloads (Total). Calculate the share of redownloads and the cost per new download (Spend ÷ New Downloads (Total)) for each campaign.

For: app developers and founders · growth leads · agencies

Fields used: Campaign NameSpendInstalls (Tap-Through)Installs (View-Through)Installs (Total)New Downloads (Total)Redownloads (Total)

Can Claude tell if the ads or product page dropped installs?

You know whether to work on bids or on the product page before you touch either.

Prompt

For the last 6 weeks, by Week and Campaign Name, show Impressions, Taps, TTR, Avg CPT, Installs (Total) and CR (Total). For campaigns where Installs (Total) fell more than 20% week over week, tell me whether Impressions, TTR or CR (Total) fell most.

Then ask

Prompt

For the last 30 days, by Ad Name, Product Page ID and Creative Type, show Taps, Installs (Tap-Through) and CR (Tap-Through), and rank ads with at least 100 Taps.

For: in-house UA managers · ASO and product-page owners · agencies

Fields used: WeekCampaign NameImpressionsTapsTTRAvg CPTInstalls (Total)CR (Total)Ad NameProduct Page IDCreative TypeInstalls (Tap-Through)CR (Tap-Through)

Can Claude pace Apple Ads spend and change budgets, bids and status?

Budget moves to the capped campaign that’s earning installs, instead of month end telling you which one starved.

Prompt

This month, by Date and Campaign Name, show Spend, Installs (Total) and Avg CPA (Total). Then list my campaigns with their daily budgets. Using the last 7 days' average Spend, which campaigns will spend more than 90% of their daily budget every day, and which spend less than 50%?

Then ask

Prompt

Raise by 20% the daily budget of the best-CPA campaign that's hitting its cap, and pause the campaign with the worst Avg CPA (Total). Show me both changes before you make them.

For: agencies · in-house UA managers

Fields used: DateCampaign NameSpendInstalls (Total)Avg CPA (Total)

Actions: campaign_list (daily budgets) · adgroup_list · campaign_update · adgroup_update

Can Claude build a campaign from a brief?

Country, ad group, keywords and negatives come from one prompt, so your time goes into checking the setup, not typing it.

Prompt

Create a paused search results campaign 'US – Brand' for my app {app name} in the United States with a $50 daily budget. Add one ad group 'Brand exact' with a $1.50 default bid, Search Match off, and the exact-match keywords {keyword 1}, {keyword 2}, {keyword 3}. Add {competitor} as a campaign negative. Show me each item before you create it.

For: agencies · in-house UA managers · app developers

Actions: organization_list · campaign_create · adgroup_create · keyword_create · negativekeyword_create · read-back campaign_list · adgroup_list

Can Claude compare cost per install with Meta Ads app campaigns?

Both channels land in one cost-per-install table, so the budget split starts from numbers, not from whichever dashboard is open.

Prompt

For the last 30 days, show my Apple Ads Spend and Installs (Total) by Campaign Name, then my Meta Ads Amount spent and App installs by Campaign name. Calculate cost per install for every campaign, put both platforms in one table, and tell me which three campaigns should get more budget.

For: growth leads · agencies · app developers

Fields used: Campaign NameSpendInstalls (Total)Campaign nameAmount spentApp installs

03Why Porter

Why Porter for Apple Ads in Claude

Apple publishes no MCP server for Claude (as of October 2026), so Porter runs on Apple’s own API and you host nothing. If you also want an AI agent for keyword bid changes, keyword pauses, ads or impression share, a community server such as ppcprophet/apple-ads-mcp on GitHub, or your own build on Apple’s API, is the route for those.

✓

Nothing to host

Add one MCP URL to Claude and Porter runs the rest. You skip the key pair, the client secret and the 1-hour tokens a build on Apple’s API needs.

⊞

Changes only after you approve

Claude shows every change before Porter sends it to Apple Ads, and new campaigns start paused. An API user with a reporting-only role keeps Claude to questions.

⚙

120+ ready-made fields

Claude gets named fields for keywords, search terms, ads and installs by type, new downloads included. Prompts ask one level at a time, so totals match Apple’s reports.

Apple Ads next to your other channels

Ask about Apple Ads next to Meta Ads, Google Ads and GA4 in the same chat, so budget calls between platforms don’t need a spreadsheet first.

↻

One connection for every tool

One Apple Ads organization connected in Porter also feeds ChatGPT and Data Studio at no extra cost, so you don’t reconnect for each tool.

04Pricing

Pricing

You can start free, since Porter’s Apple Ads connector for Claude comes with every plan. Use the calculator for your number of accounts, or see Porter pricing for every plan.

What you get

Free plan: the MCP, unlimited connected accounts and 30 days of history (15 days in AI chats)
Reporting: from $12.50 per account a month billed annually, or $15 month to month for one account
Billing: each connected Apple Ads organization counts as one account, with volume discounts and no per-seat fee
Changes: 1 AI credit per completed change; failed tasks are free, and the Free plan includes 100 credits a month
Trial: 14 days of full access, no card

See full pricing and plans

Price calculator

Data source accounts

$33.33/mo$6.67 per account

An account is one ad account, Stripe account, store, page or GA4 property. The Free plan has unlimited accounts with 30 days of history.

05Data and actions

Apple Ads data and actions in Claude

The connector gives Claude 120+ Apple Ads fields across organizations, apps, campaigns, ad groups, keywords, search terms and ads. It also adds 16 actions to read, create, change and delete. However, most questions need only the 12 field groups below. The Apple Ads field list has every label and ID.

The 12 fields you'll use most

Field	What it's for
Date · Weekapple_ads_date · apple_ads_week	Daily pacing and week-over-week comparisons
Org ID · App Nameapple_ads_orgId · apple_ads_appName	Telling organizations and apps apart
Campaign Name · Ad Group Nameapple_ads_campaignName · apple_ads_adGroupName	The level of the question (one per prompt)
Keyword · Match Type · Keyword Bid Amountapple_ads_keyword · apple_ads_matchType · apple_ads_bidAmount	Keyword cost and bid reviews
Search Term · Search Term Sourceapple_ads_searchTermText · apple_ads_searchTermSource	What people typed in the App Store and how it matched
Search Matchapple_ads_automatedKeywordsOptIn	Whether an ad group matches searches automatically
Spend · Avg CPTapple_ads_localSpend · apple_ads_avgCPT	Cost and cost per tap
Impressions · Taps · TTRapple_ads_impressions · apple_ads_taps · apple_ads_ttr	Reach and tap-through rate
Installs (Total) · Installs (Tap-Through) · Installs (View-Through)apple_ads_totalInstalls · apple_ads_tapInstalls · apple_ads_viewInstalls	Installs by how they were attributed
New Downloads (Total) · Redownloads (Total)apple_ads_totalNewDownloads · apple_ads_totalRedownloads	New users vs returning users
Avg CPA (Total) · CR (Total)apple_ads_totalAvgCPI · apple_ads_totalInstallRate	Cost per install and tap-to-install rate
Ad Name · Product Page ID · Creative Typeapple_ads_adName · apple_ads_productPageId · apple_ads_creativeType	Which ad and product page drove installs

Can Claude create, pause or change Apple Ads campaigns?

Yes. Claude creates campaigns for an app in the countries you choose, with a daily budget. Then it creates ad groups with a default bid, CPA goal, dates and Search Match. It adds keywords with match type and bid, as well as campaign negative keywords. Claude also pauses, resumes and deletes campaigns and ad groups.

It also changes names, daily budgets, default bids, CPA goals, end dates and Search Match. Keyword bid changes, keyword pauses or deletes, negative removals, ads and custom product pages stay in Apple Ads, where you manage them as usual.

How fresh is the data, and how far back?

Porter fetches data when you ask. Today's numbers come back marked as an incomplete day, so ask for full days. So far, Porter has returned daily data back to January 2024 on a tested account. The free plan reads 15 days in AI chats (30 days of history), but paid plans have no history cap.

Product stats

What	Apple Ads connector
Fields	120+ across organizations, apps, campaigns, ad groups, keywords, search terms and ads
Actions	16 to read, create, change and delete; keyword bids, ads and custom product pages stay in Apple Ads
Freshness	Fetched when you ask; today comes back as an incomplete day
History	Daily data back to January 2024 on a tested account; no cap on paid plans; 30 days on the Free plan, 15 in AI chats
Query rules	One level per question (campaigns, ad groups, keywords, search terms or ads)
Search terms	Terms with 10 impressions or fewer come back as one unnamed row
Access	Apple Ads Advanced API user; Read Only for questions, a read and write role for changes

See all 120+ Apple Ads fields

06Security

Is it safe?

Yes, with approvals. Claude shows every change before the connector sends it to Apple Ads, and nothing changes until you confirm. Deleting a campaign or ad group is permanent, so pausing is the safer fix. Porter works with the access your API user already has, so a reporting role keeps Claude to questions.

How approvals work

New campaigns start paused when Claude creates them through Porter. Deleting a campaign or ad group is permanent, so Claude shows it to you before it runs. Keyword edits beyond adding keywords stay in Apple Ads. Each completed change uses one AI credit, so bulk changes count per item.

What the Claude connector needs from Apple Ads

You need an Apple Ads Advanced organization, as well as an API user invited by an account admin. API Account Read Only is enough for questions, but changes need a read and write role, or Apple rejects the request. One API user can reach several organizations, and its client secret lasts up to 180 days (Apple's OAuth guide: API roles and the 180-day client secret).

07FAQ

FAQ

The first five answers cover the name change, other AI tools and agencies, as well as reusing a Porter connection and Apple's API change. The last three help when numbers or questions look wrong, each with the check to run first.

Is Apple Search Ads the same as Apple Ads?

Yes. Apple Ads, formerly Apple Search Ads, is the same platform, renamed on April 14, 2025 as its ads grew beyond App Store search (Apple's announcement of the Apple Ads name). Campaigns, keywords and the API stayed the same, so Porter covers accounts under both names.

Does Porter work in ChatGPT and Claude Code too?

Yes. The MCP URL behind the Apple Ads connector works in ChatGPT and Claude Code, so your prompts move between tools unchanged. For ChatGPT, follow Porter's guide to connect Apple Ads to ChatGPT. For Claude Code, Porter's Apple Ads to Claude setup guide also has its own walkthrough.

Can I connect several Apple Ads organizations or apps, like an agency?

Yes. One Apple Ads API user can reach every organization it's invited to, and each organization connects to Porter as one account, billed once. Add App Name as a column to compare apps inside an organization, then Org ID to compare organizations.

I already send Apple Ads to Data Studio with Porter. Do I need to reconnect?

No. One Apple Ads organization connected in Porter feeds every Porter destination, including Claude, at no extra cost. If you already use Porter's Apple Ads connector for Data Studio (formerly Looker Studio), add the MCP URL to Claude and start asking.

What happens when Apple retires the Campaign Management API in January 2027?

Apple sunsets Campaign Management API v5 on January 26, 2027 and points developers to the Apple Ads Platform API. Porter reads and writes your App Store campaigns through v5 today, while Apple Maps campaigns run on Apple's newer API.

Troubleshooting

Why don't Claude's numbers match the Apple Ads dashboard?

Compare full days in your organization's time zone, and Claude's Apple Ads numbers through Porter should line up with the dashboard. "Installs" means tap-through plus view-through, and today is still an incomplete day. Search terms report in your organization's time zone, and terms with 10 impressions or fewer sit in one unnamed row (Apple's search term reporting rules).

Why does Claude return no data for my Apple Ads account?

Check that your account signs in through Apple Ads Advanced and that an admin invited the API user to the right organization, then reconnect Apple Ads in Porter. Claude returns no Apple Ads data through Porter when the account is Apple Ads Basic or the API user has no access to that organization.

Why did an Apple Ads question fail in Claude?

Ask one level at a time, and Claude reads budgets and CPA goals from your campaign and ad group lists. An Apple Ads question fails when it mixes levels, since campaign fields don't combine with keyword fields. It also fails with Budget Amount, Total Budget, CPA Goal, Target CPA, Suggested Bid Amount or Ad Serving Status, so Claude uses the lists for those.

08Next

More Claude connectors

Porter brings more than Apple Ads into Claude, and sends Apple Ads to more places than Claude. Besides the Apple Ads connector, try another ad platform or analytics source from all Claude connectors, or send Apple Ads to a warehouse. Each page also lists its own prompts, fields and limits.

→

Google Ads connector for Claude

→

TikTok Ads connector for Claude

→

Google Analytics 4 connector for Claude

→

Apple Ads to BigQuery

MCP servers for marketing reports

Try the Claude connector on your ads

Set up the Apple Ads connector for Claude in 3 steps, then run your first keyword review today. Ask which keywords install cheapest, which search terms to add or block, and why installs dipped, then make the changes in the same chat.

Free plan · 14-day full trial · No card

App developers and founders: which keywords and search terms bring new users, and what each one costs, in one chat.

UA managers: the search-term harvest and the budget check become prompts you rerun each week instead of spreadsheets.

Agencies: every client organization answers the same prompt, while Org ID and App Name keep apps apart.

About the author: Porter Metrics team. The team builds and tests Porter's marketing data connectors, including the Apple Ads connector and the prompts on this page.Last updated October 19, 2026

How to connect Apple Ads to Claude

What you need first

Step 1: Connect Apple Ads in Porter

Step 2: Add the Apple Ads connector to Claude

Step 3: Ask Claude about Apple Ads

Guides and videos

What you can ask Claude

Can Claude find the Apple Ads keywords that bring installs at the lowest CPA?

Can Claude turn search terms into exact-match keywords and negatives?

Can Claude tell if Search Match is worth the spend?

Are installs new users or redownloads, from taps or views?

Can Claude tell if the ads or product page dropped installs?

Can Claude pace Apple Ads spend and change budgets, bids and status?

Can Claude build a campaign from a brief?

Can Claude compare cost per install with Meta Ads app campaigns?

Why Porter for Apple Ads in Claude

Nothing to host

Changes only after you approve

120+ ready-made fields

Apple Ads next to your other channels

One connection for every tool

Pricing

What you get

Price calculator

Apple Ads data and actions in Claude

The 12 fields you'll use most

Can Claude create, pause or change Apple Ads campaigns?

How fresh is the data, and how far back?

Product stats

Is it safe?

How approvals work

What the Claude connector needs from Apple Ads

FAQ

Is Apple Search Ads the same as Apple Ads?

Does Porter work in ChatGPT and Claude Code too?

Can I connect several Apple Ads organizations or apps, like an agency?

I already send Apple Ads to Data Studio with Porter. Do I need to reconnect?

What happens when Apple retires the Campaign Management API in January 2027?

Troubleshooting

Why don't Claude's numbers match the Apple Ads dashboard?

Why does Claude return no data for my Apple Ads account?

Why did an Apple Ads question fail in Claude?

More Claude connectors

Try the Claude connector on your ads