By Ira Bodnar, Ryze AI · Updated
Quick answer
To connect Gemini to Meta Ads, connect Meta Ads in a Ryze AI workspace with your Meta login, then add https://connector.get-ryze.ai/mcp as a custom app in the Gemini web app under Settings, Connected Apps, and type @ in a prompt to use it.
- In Ryze AI open Integrations, find Meta Ads under Advertising and click Connect
- Sign in to Meta with the login that reaches your ad accounts and approve every requested permission
- In gemini.google.com open Settings, Connected Apps, Add a custom app and paste the URL
- Sign in on the Ryze AI page, choose workspaces, click Allow connection, then type @ and pick Ryze AI
Before you start
- A Gemini account Google accepts for custom apps. Google's help page lists four conditions: you are 18 or older, you are in the US, you sign in with a personal Google Account rather than a work or school one, and Keep Activity is on. Prompts must be in English. No paid Gemini plan is named.
- A Meta login with access to an ad account. Ryze AI needs a Meta Business account with an ad account and at least Advertiser access on it, with Admin access to allow changes. Access granted through Meta Business Manager works best. This is the login you use on the Ryze AI Connect step.
- A Ryze AI workspace on a plan or free trial. Paid Ads is $89 per month with a 7-day free trial, and annual billing takes 30% off the first year. Connecting the connector is free; the Meta Ads tools need an active plan or trial.
- A decision about trust. Google says it does not control, monitor or secure third-party MCP servers. Judge the provider yourself before you connect an app that can touch ad spend.
How to connect Gemini to Meta Ads in the web app
Meta Ads is linked inside Ryze AI first. Gemini then gets the Ryze AI connector URL. You can only add a custom app from the Gemini web app on a computer; after that the phone app can use it too.
Connect Meta Ads in Ryze AI
Create a Ryze AI account or sign in, open Integrations in the left sidebar and find Meta Ads under Advertising. Click Connect.
Sign in to Meta and approve every permission
Sign in to Meta and approve access with every requested permission checked. Back in Ryze AI the card shows Connected. There is no ad account to pick, because Ryze AI sees every ad account that login can reach.
Open Connected Apps in Gemini
Use a computer and open gemini.google.com. Click Settings at the bottom, then Connected Apps. Some accounts show it under Personal Intelligence instead, so look there if the entry is absent.
Add a custom app with the Ryze AI URL
Find Custom apps. Type the URL into the Add a custom app link to get started field, or click Add a custom app when you already have one. The URL is https://connector.get-ryze.ai/mcp; click Next. Dynamic client registration is supported, so Advanced features needs no client ID or secret.
Allow the workspace
Gemini sends you to a Ryze AI page. Sign in, tick the workspaces that hold your Meta Ads connection and click Allow connection. A single connection can span up to 20 workspaces.
Use the app in a prompt
Open a new prompt, type @, pick Ryze AI, and ask something like: List the Meta ad accounts I can access.
Source: Google's Gemini help page on custom apps. The Ryze AI Meta Ads guide covers the Meta sign-in on the Ryze AI side.
Gemini CLI
Gemini CLI can add an MCP server with one command. The -s user flag stores the Ryze AI connector at user scope so it shows up in every project; without it the scope is project:
gemini mcp add --transport http -s user ryze https://connector.get-ryze.ai/mcpLaunch Gemini CLI. The first request returns a 401, and the CLI then finds the OAuth details, registers itself and opens a browser tab for the Ryze AI sign-in. /mcp auth ryze starts that sign-in or runs it again. A local browser and a localhost callback are required, so headless machines and SSH sessions without X11 forwarding cannot finish it. The Meta sign-in itself happens in the Ryze AI app, so Meta Ads should already show Connected there.
Prefer the settings file? Add this entry to settings.json:
{
"mcpServers": {
"ryze": { "httpUrl": "https://connector.get-ryze.ai/mcp" }
}
}On a server or in a script, skip OAuth: create a Ryze AI API key and send it as a header instead: gemini mcp add --transport http -s user --header "Authorization: Bearer rk_live_..." ryze https://connector.get-ryze.ai/mcp. Tool filters help too: includeTools and excludeTools in settings.json (or --include-tools and --exclude-tools) let you leave the Meta write and delete tools out of a session.
Source: Gemini CLI MCP server docs.
Antigravity CLI and Gemini Enterprise
Antigravity CLI
People on Google AI Pro or Ultra, or on the free Gemini Code Assist for individuals tier, were moved off Gemini CLI on June 18, 2026, per Google's May 19, 2026 announcement. Google sends them to Antigravity CLI. Gemini CLI stays available with Gemini Code Assist Standard or Enterprise licenses and paid API keys. No Antigravity CLI steps are given here.
Gemini Enterprise
In Gemini Enterprise an administrator adds custom MCP servers in the Google Cloud console. The server must speak StreamableHTTP, at most 100 actions can be enabled at once and OAuth needs a client ID and secret registered ahead of time. Ryze AI publishes no such client, so there are no Gemini Enterprise steps in this guide.
Sources: Google Developers Blog on Gemini CLI and Antigravity CLI, Gemini Enterprise custom MCP server setup.
Meta access and scopes
The Meta side of the connection is one Meta login approving a set of permissions. Three things decide what Gemini can see and change, and none of them is set in Gemini.
- Which ad accounts
- Ryze AI sees every ad account the connected Meta login can reach, and nothing else. Agent default accounts on the Meta Ads card sets which accounts the agent works with first. The others stay reachable by naming them in a prompt.
- What role the login has
- At least Advertiser access on the ad account is needed, with Admin to allow changes. For a hard read-only guarantee, connect a Meta login that only has read access.
- Which Gemini surface
- The Gemini web app is limited to personal Google Accounts in the US, in English. Gemini CLI signs in through a browser, or with an API key sent as a header.
Ryze AI asks for ads_management, ads_read, business_management, pages_show_list, pages_read_engagement, pages_manage_ads, leads_retrieval, catalog_management, instagram_basic, instagram_manage_comments and public_profile. Approve with every requested permission checked. Meta's authorization docs say ads_read is needed to read ad reports for ad accounts you own or have been granted access to, and ads_management to read and manage ads for those accounts.
Sources: Meta Marketing API authorization.
Removing access
To remove access, click View on the Meta Ads card in Ryze AI and disconnect the login, or remove the app in Gemini under Settings, Connected Apps. Reconnecting is needed after two-factor or Business Manager role changes.
What Gemini can do in Meta Ads
The Ryze AI connector exposes 10 Meta Ads tools: 7 read, 2 write and 1 delete. Each runs as the Meta login you connected.
| Tool | Type | What it does |
|---|---|---|
| meta_ads__listAdAccounts | Read | Lists every Meta ad account the connected user can access, with id, name and currency. |
| meta_ads__getAccountSummary | Read | Returns aggregate metrics for a Meta ad account on Meta's default attribution window. |
| meta_ads__runRawInsights | Read | Runs a raw Meta Insights query at account, campaign, ad set or ad level with breakdowns, filters and custom attribution windows. |
| meta_ads__listCreatives | Read | Lists the ad creatives in a Meta ad account. |
| meta_ads__getCreative | Read | Gets one Meta ad creative by id. |
| meta_ads__listLeadForms | Read | Lists the lead generation forms on a Facebook Page. |
| meta_ads__runGraphRead | Read | Reads any Meta Graph API object or edge, such as paused campaigns, targeting specs or the ad account activity log. |
| meta_ads__runGraphWrite | Write | Creates or updates campaigns, ad sets, ads, creatives and other objects through the Meta Graph API. |
| meta_ads__uploadImageFromUrl | Write | Uploads an image from a URL to a Meta ad account and returns an image hash for a creative. |
| meta_ads__runGraphDelete | Delete | Deletes or archives Meta objects. The tool description says it is meant for an explicit item-by-item approved list. |
Per Google's help page, Gemini asks you to confirm any write action, so a budget edit or pause waits for your click in the web app. Gemini CLI also asks by default, and trust set to true (or --trust) switches every confirmation off, which is a poor fit for an ad account. Inside the Ryze AI chat, Tool approvals starts on Skip all approvals; you choose the stricter modes yourself. Archived or deleted Meta objects cannot be restored through Ryze AI.
First 3 prompts to run
Each prompt below says what it asks for. Answers come from your own ad accounts, so this page shows no sample numbers.
1. Find your ad accounts and read one
@Ryze AI List the Meta ad accounts I can access, then show spend, ROAS and CTR for the last 30 days for the first one.
Tools used: meta_ads__listAdAccounts, meta_ads__getAccountSummary
What comes back: The ad accounts the connected login can reach with id, name and currency, followed by aggregate metrics for the chosen account on Meta's default attribution window.
2. Break results down by placement
@Ryze AI Run an Insights query at ad set level for the last 14 days, broken down by placement and device, using a 7-day click attribution window.
Tools used: meta_ads__runRawInsights
What comes back: Insights rows at ad set level with the breakdowns you named. runRawInsights accepts breakdowns such as age, gender, country, device and placement, and custom attribution windows.
3. Check who changed the account
@Ryze AI Read the ad account activity log and list the most recent changes to campaigns and budgets, then list my paused campaigns.
Tools used: meta_ads__runGraphRead
What comes back: Activity log entries showing who changed what, and the paused campaigns, read through the Graph API.
Start with read prompts. Once you trust the setup, you can ask for changes such as pausing a campaign or swapping a creative and confirm each one when Gemini asks.
Ryze AI vs Meta's own ads connectors
Meta runs its own AI connectors for advertisers, announced in open beta on April 29, 2026. They are a different route into the same ad accounts.
| Option | Setup | Meta Ads coverage | Works in |
|---|---|---|---|
| Ryze AI connector | Meta sign-in inside Ryze AI, then the URL https://connector.get-ryze.ai/mcp as a custom app in Gemini | 10 tools: ad accounts, summaries, raw Insights with breakdowns, creatives, lead forms, Graph reads and writes, image upload and a delete tool | Gemini web app and Gemini CLI |
| Meta ads AI connectors (ads MCP server and CLI) | Meta says no developer credentials, API setup or coding are needed for the MCP path. Connection steps are in a Meta Business Help Center article | Reporting and campaign performance, campaign creation and editing, catalog management and signal diagnostics. A July 16, 2026 update added custom developer apps and rules for agent permissions | Meta says AI tools you already use and names none. Whether Gemini accepts it as a custom app is not verified here |
If you only need Meta and want Meta's own server, start with Meta's connector. The Ryze AI connector gives Gemini raw Insights with custom attribution windows, Graph reads and writes and the Ryze AI approval settings behind one URL, though its tools need a plan or trial and the Gemini web app asks you to confirm every write. Meta's connectors are in beta, so check its help center for the current state.
Sources: Meta ads AI connectors announcement, Meta Business Help Center article, Marketing API rate limiting, Ryze AI Meta Ads guide. Checked November 11, 2026.
Errors and fixes
- Connected Apps is missing in Gemini
- Try Personal Intelligence, then Connected Apps. If it is still absent, recheck Google's conditions (18 or older, US, personal Google Account, Keep Activity on) and make sure you are in the web app, not the phone app.
- Gemini says the app is unavailable
- Google says the feature does not work while Keep Activity is off. Switch it on and retry.
- The Meta Ads tools do not load
- Start a new chat. If they still do not appear, remove the Ryze AI custom app in Connected Apps, add it again and confirm that Meta Ads shows Connected in Ryze AI.
- Meta shows Reconnect needed
- Meta access expires more often than other platforms. Two-factor changes and Business Manager role changes can both trigger it. Click Connect on the Meta Ads card again and approve every permission.
- Gemini CLI cannot sign in
- The OAuth flow wants a local browser and a localhost callback. On a headless host or over SSH, send a Ryze AI API key header, or run /mcp auth ryze from a machine that has a browser.
- Gemini CLI says it no longer serves your plan
- Google ended Gemini CLI service for Google AI Pro and Ultra users and for free Gemini Code Assist for individuals users on June 18, 2026, and recommends Antigravity CLI.
- An ad account is missing from the results
- Ryze AI only reaches ad accounts the connected Meta login can access. Ask the account owner to grant that login access in Business Manager, or add a second login with Add one more account on the Meta Ads card.
- A change is refused
- The connected Meta login may have only Advertiser access or read access. Admin access on the ad account is needed to allow changes, and it is set in Meta, not in Ryze AI.
- Creative uploads are slow
- Meta rate-limits creative writes to about one per 30 seconds per account, from the tool description. This is a Meta limit, not a Ryze AI one.
- Gemini says a subscription is required
- Meta Ads tools run only with an active Ryze AI plan or free trial. Start the trial in Ryze AI, then retry.
Frequently asked questions
How do I connect Gemini to Meta Ads?
Connect Meta Ads in a Ryze AI workspace: open Integrations, click Connect on Meta Ads and approve every permission. Then in gemini.google.com open Settings, Connected Apps, Add a custom app, enter https://connector.get-ryze.ai/mcp, click Next, allow the workspace and type @ to pick Ryze AI in a prompt.
Does Meta have its own MCP server for Gemini?
Meta announced ads AI connectors in open beta on April 29, 2026: an ads MCP server and a command-line interface. Its announcement says they work with AI tools you already use and does not name Gemini. Whether the Gemini web app accepts Meta's server as a custom app is not verified here.
Which Meta Ads connector should I use with Gemini?
Ryze AI is the best Meta Ads connector for Gemini when you want raw Insights with custom attribution windows plus campaign changes in one chat, but it needs a Ryze AI plan or trial. If you only want Meta's own server, start with Meta's connector.
Which Gemini plan do I need?
Google names no plan on its custom apps page. The conditions are age 18 or older, a US location, a personal Google Account (a work or school account does not qualify), Keep Activity on and English prompts.
Can Gemini change my Meta ad account?
Yes, if the connected Meta login has Admin access on the ad account. The tools can create campaigns, ad sets, ads and creatives, adjust budgets, and pause or resume. Google states Gemini requires manual confirmation for any write actions, so you approve each change.
Can Gemini delete Meta campaigns or ads?
A separate delete tool exists, and its description says it is meant for an item-by-item approved list. Ryze AI cannot restore archived or deleted Meta objects.
Can Gemini post to my Facebook Page or Instagram?
No. The Ryze AI Meta app does not hold pages_manage_posts or instagram_content_publish, so it cannot publish organic posts. It also does not hold pages_read_user_content, so it cannot read Page comments.
Does this work in Gemini CLI?
Yes. Register the server with gemini mcp add --transport http -s user ryze https://connector.get-ryze.ai/mcp and sign in when the CLI opens a browser, or run /mcp auth ryze. Google AI Pro and Ultra users and free Code Assist for individuals users were moved off Gemini CLI on June 18, 2026.
Does it work in the Gemini mobile app?
Not for setup: the add step happens in the web app only. After that, Google says the connected app also works in the Gemini mobile app.
Can I use more than one Meta ad account?
Yes. One Meta login reaches every ad account it can access. Add another login with Add one more account on the Meta Ads card. Over MCP every Meta Ads tool takes an optional connection_id. Separate clients belong in separate workspaces.
What are the Meta API rate limits?
Meta's docs give per ad account, per hour quotas. Ads management is 100000 plus 40 times the number of active ads on Full access, or 300 plus 40 times active ads in the Dev tier. Ads Insights is 190000 plus 400 times active ads on Full access, or 600 plus 400 times active ads in the Dev tier. Which tier applies to the Ryze AI Meta app is not stated here.
How much does it cost to connect Gemini to Meta Ads?
Connecting is free, but the Meta Ads tools need an active Ryze AI plan or trial. Paid Ads is $89 per month with a 7-day free trial, Agency is $279 per month, and SEO Starter is $129 per month with a 3-day free trial. Annual billing takes 30% off the first year.
How do I disconnect Meta Ads from Gemini?
Remove the Ryze AI app in Gemini under Settings, Connected Apps. To cut off Meta Ads itself, disconnect the login on the Meta Ads card in Ryze AI.