Meta Ads MCP Server

MCP server for the Meta Marketing API v26.0 - 135 tools for managing Facebook & Instagram ad campaigns, audiences, creatives, insights, catalogs, and more. Its 40 documented tools cover campaign, adset, creative, copy. It runs locally over stdio via the published package.

People connecting social media tools to Claude, Cursor, VS Code, or another MCP client. The project is written in TypeScript.

VERIFIED ACTIVE

LAST COMMIT 2026-08-06 · ★ 70 · #3 OF 46 MAINTAINED SOCIAL MEDIA · VERIFIED 2026-08-25

MIT · TypeScript servers · how we verify → /methodology

01 · Install Meta Ads

before you install - you'll need

Set META_ADS_ACCESS_TOKEN, META_AD_ACCOUNT_ID before connecting. META_APP_ID, META_APP_SECRET, META_BUSINESS_ID, META_PIXEL_ID are optional or environment-specific per the README.

Claude Code

claude mcp add mikusnuz-meta-ads-mcp -- npx -y @mikusnuz/meta-ads-mcp

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "mikusnuz-meta-ads-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@mikusnuz/meta-ads-mcp"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

npm package @mikusnuz/meta-ads-mcp - published under the repo owner's npm scope (@mikusnuz)

registry namespace io.github.mikusnuz is GitHub-verified and matches the repo owner

03 · What Meta Ads can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can list campaigns with filtering and pagination, get campaign details by ID, create a new campaign, and update campaign settings.

Capability map

Tools grouped from the project's README - what Meta Ads lets an agent do.

read & search

9 tools - e.g. List campaigns with filtering and pagination; List ad sets with filtering; List ads with filtering

list_campaigns · list_adsets · list_ads · get_ad · get_ad_preview · get_delivery_estimate…

Campaign

8 tools - e.g. Get campaign details by ID; Create a new campaign; Update campaign settings

get_campaign · create_campaign · update_campaign · delete_campaign · copy_campaign · get_campaign_adsets…

Adset

7 tools - e.g. Get ad set details by ID; Create a new ad set; Update ad set settings

get_adset · create_adset · update_adset · delete_adset · get_adset_targeting_sentence · get_adset_ads…

Creative

4 tools - e.g. Get creative details; Create a new ad creative; Update an ad creative

get_creative · create_creative · update_creative · create_dynamic_creative

Image

3 tools - e.g. Upload an image from a URL or local file; Get image details; Delete an image

upload_image · get_image · delete_image

Video

3 tools - e.g. Upload a video from a URL or local file; Get video details; Delete a video

upload_video · get_video · delete_video

Copy

2 tools - e.g. Copy an existing ad set to same or different campaign; Copy an existing ad to same or different ad set

copy_adset · copy_ad

create & write

1 tool - e.g. Create a new ad

create_ad

Latest releases

v1.3.0 · 2026-04-12

New Tools (+12, total 135) · Copy Operations · copy_campaign - Duplicate existing campaigns with ad sets and ads · copy_adset - Copy ad sets to same or different campaign · copy_ad - Copy ads to same or different ad…

v1.2.1 · 2026-03-19

Release v1.2.1

04 · Who maintains Meta Ads

meta-ads is maintained by mikusnuz. We track 9 MCP servers from mikusnuz - 9 actively maintained, 135 combined GitHub stars, oldest repo from Feb 2026. Full record: all servers from mikusnuz.

05 · Facts

repository: github.com/mikusnuz/meta-ads-mcp
category: social media - ranked #3 of 46 actively-maintained social media servers as of 2026-08-25.
registry: io.github.mikusnuz/meta-ads (active, first published 2026-03-19)
packages: npm:@mikusnuz/meta-ads-mcp

06 · Meta Ads FAQ

Is Meta Ads still maintained?

Yes - as of 2026-08-25, its last commit was 2026-08-06. We re-verify nightly.

What can Meta Ads do?

With this server connected, an agent can list campaigns with filtering and pagination, get campaign details by ID, create a new campaign, and update campaign settings.

How do I install Meta Ads?

Run `npx -y @mikusnuz/meta-ads-mcp`. The README documents 6 environment variables (META_ADS_ACCESS_TOKEN, META_AD_ACCOUNT_ID, META_APP_ID…) to set first. Set META_ADS_ACCESS_TOKEN, META_AD_ACCOUNT_ID before connecting. META_APP_ID, META_APP_SECRET, META_BUSINESS_ID, META_PIXEL_ID are optional or environment-specific per the README. You can also paste the ready-made client config above.

Does Meta Ads run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Meta Ads

Alternatives to Meta Ads

Maintained social media servers if Meta Ads isn't the fit.

More social media MCP servers · Meta · YouTube MCP · Reddit MCP Server (mypracticaltools) · Tweetkit X · Pendpost

More TypeScript MCP servers · Umami · Imagenate · Apple Shortcuts (mindstone) · Browser Automation · see all