← Back to Meta Ads

Install Meta Ads

Pick your client, copy the command, done.

other
1

Add it to Claude Code

claude mcp add -e "META_ADS_ACCESS_TOKEN=${META_ADS_ACCESS_TOKEN}" -e "META_AD_ACCOUNT_ID=${META_AD_ACCOUNT_ID}" meta-ads -- npx -y @mikusnuz/meta-ads-mcp
Required:META_ADS_ACCESS_TOKENMETA_AD_ACCOUNT_ID+ 4 optional

Environment Variables

Set these before running Meta Ads.

VariableDescriptionRequired
META_ADS_ACCESS_TOKENMeta Marketing API access tokenYes
META_AD_ACCOUNT_IDAd account ID (numeric, without act_ prefix)Yes
META_APP_IDApp ID — required for token exchange/debugNo
META_APP_SECRETApp secret — required for token exchange/debugNo
META_BUSINESS_IDBusiness Manager ID — required for business toolsNo
META_PIXEL_IDPixel ID — required for conversion toolsNo

Available Tools (44)

Once configured, Meta Ads gives your AI agent access to:

list_campaignsList campaigns with filtering and pagination
get_campaignGet campaign details by ID
create_campaignCreate a new campaign
update_campaignUpdate campaign settings
delete_campaignDelete a campaign
get_campaign_adsetsList ad sets within a campaign
get_campaign_adsList ads within a campaign
get_campaign_leadsGet leads from a campaign
list_adsetsList ad sets with filtering
get_adsetGet ad set details by ID
create_adsetCreate a new ad set
update_adsetUpdate ad set settings
delete_adsetDelete an ad set
get_adset_adsList ads within an ad set
get_adset_leadsGet leads from an ad set
list_adsList ads with filtering
get_adGet ad details by ID
create_adCreate a new ad
update_adUpdate ad settings
delete_adDelete an ad
get_ad_previewGenerate ad preview HTML
get_delivery_estimateGet delivery estimate for an ad
list_creativesList ad creatives
get_creativeGet creative details
create_creativeCreate a new ad creative
update_creativeUpdate an ad creative
create_dynamic_creativeCreate a dynamic creative
list_imagesList ad images
upload_imageUpload an image from URL
get_imageGet image details
delete_imageDelete an image
list_videosList ad videos
upload_videoUpload a video from URL
get_videoGet video details
delete_videoDelete a video
list_canvasesList Instant Experience canvases
get_canvasGet canvas details
create_canvasCreate a canvas
delete_canvasDelete a canvas
list_custom_audiencesList custom audiences
get_audienceGet audience details
create_custom_audienceCreate a custom audience
update_audienceUpdate audience settings
delete_audienceDelete an audience

Try It Out

After setup, try these prompts with your AI agent:

→Create a new Facebook ad campaign with a daily budget of $50.
→Check how my ads are performing today and list any campaigns with low ROAS.
→Pause all campaigns that have a ROAS below 2.
→Upload this image URL to my ad account and create a new creative.
→Get a detailed performance report for the last 30 days.
Prerequisites & system requirements
  • An MCP-compatible client (Claude Code, Cursor, Windsurf, Claude Desktop, or Codex)
  • Node.js 18+ with npm/npx installed
  • META_ADS_ACCESS_TOKEN — Meta Marketing API access token
  • META_AD_ACCOUNT_ID — Ad account ID (numeric, without act_ prefix)

Keep this setup from going cold

Save the docs, env vars, and workflow around Meta Ads in Conare so Claude Code, Codex, and Cursor remember it next time.

Remember this setup
← Meta Ads overview Browse other servers →