Meta Ads MCP
Allows management of Facebook campaigns, ad sets, ads, and creatives through the Meta Marketing API, including reading insights and changing campaign status or budgets.
Supports managing Instagram campaigns, ad sets, ads, and creatives through the Meta Marketing API, and can read Instagram media and stories when the required Instagram permissions are granted.
Integrates with the Meta Marketing API (Graph API) to manage campaigns, ad sets, ads, creatives, audiences, pixels, and performance insights for a Meta ad account, with guarded write operations for creating, updating, copying, activating, pausing, archiving, and deleting objects.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Meta Ads MCP show me last week's campaign performance and pause the worst one"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Meta Ads MCP
One Node.js MCP server for the Meta Marketing API (Graph API). It has no npm dependencies.
It manages Instagram and Facebook campaigns, ad sets, ads, and creatives for one ad account. It also reads insights and Instagram media.
Tools
Tool | Access | Function |
| Read | Shows the token permissions, the token expiry, and the ad account |
| Read | Lists campaigns, ad sets, ads, creatives, audiences, pixels, and media |
| Read | Gets one object by ID |
| Read | Gets performance data for the account, a campaign, an ad set, or an ad |
| Read | Finds interests, locations, locales, and categories |
| Write | Makes a campaign, ad set, creative, or ad |
| Write | Changes fields, for example budget, targeting, or name |
| Write | Sets ACTIVE, PAUSED, or ARCHIVED |
| Write | Copies a campaign, ad set, or ad |
| Write | Deletes a campaign, ad set, ad, or creative |
Related MCP server: meta-ads-mcp
Safety
A write can spend money. These rules apply to each write:
The call needs an exact change summary and
user_confirmed: true.createandcopyalways make PAUSED objects.updaterefuses a status change. Activation is a separateset_statuscall.update,set_status,copy, anddeletefirst make sure that the object belongs to the configured ad account.
Requirements
Node.js 24 or later.
The ID of a Meta ad account.
A Meta access token for that account. The read tools need
ads_read. The write tools needads_management. Instagram media and stories also need Instagram permissions.
auth_status shows the granted permissions and the token expiry.
Install
Claude Code. Load the directory for one session:
claude --plugin-dir /path/to/meta-ads-mcpFor a permanent installation, add the directory to a plugin marketplace. The plugin includes the meta-ads skill, which has campaign recipes.
Other MCP clients. Start the server on stdio:
{
"mcpServers": {
"meta_ads": {
"command": "node",
"args": ["/absolute/path/to/meta-ads-mcp/scripts/server.mjs"]
}
}
}Configuration
The source contains no account data. Put the settings in an env file with mode 600. See meta-ads.env.example.
The env file is the first of these that is set:
META_ADS_ENV_FILE$XDG_CONFIG_HOME/meta-ads/meta-ads.env~/.config/meta-ads/meta-ads.env
Variable | Content |
| The ad account ID, with or without the |
| The access token |
| Optional. The Graph API version. The default is |
A variable in the environment of the server process overrides the value in the file.
The server reads the file on each call, so a new token needs no restart. The server sends the token in the Authorization header.
Backup
node scripts/backup.mjs <output-directory>This command makes a read-only export of the ad account as JSON files: campaigns, ad sets, ads, creatives, audiences, pixels, and insights. The output contains your account data. Do not put it in a public repository.
Tests
npm test # protocol and write guards; no network, no credentials
node scripts/test.mjs --live # read-only requests to MetaLicense
MIT. See LICENSE.
Available Tools
10 toolsauth_statusARead-onlyIdempotent
Check the Meta access token, its permissions and expiry, and the configured ad account.
Inputs: no named parameters.
copyA
Copy a campaign, ad set, or ad. The copy is always PAUSED. Requires explicit user confirmation.
Inputs: id (required), change_summary (required), user_confirmed (required), params.
createA
Create a campaign, ad set, creative, or ad in the configured ad account. Campaigns, ad sets, and ads are always created PAUSED. Requires explicit user confirmation.
Inputs: params (required), object_type (required), change_summary (required), user_confirmed (required).
deleteADestructive
Delete a campaign, ad set, ad, or creative. Requires explicit confirmation of this exact deletion.
Inputs: id (required), change_summary (required), user_confirmed (required).
getARead-onlyIdempotent
Get one campaign, ad set, ad, creative, or other object by ID.
Inputs: id (required), fields.
insightsCRead-onlyIdempotent
Get performance insights for the ad account, a campaign, an ad set, or an ad.
Inputs: after, level, limit, fields, +6 more.
listARead-onlyIdempotent
List one edge of the ad account or of another object. Examples: campaigns of the account, ads of a campaign, media or stories of an Instagram account.
Inputs: edge (required), after, limit, fields, +3 more.
set_statusADestructive
Set a campaign, ad set, or ad to ACTIVE, PAUSED, or ARCHIVED. ACTIVE starts ad spend and needs its own explicit confirmation after the user reviewed the object.
Inputs: id (required), status (required), change_summary (required), user_confirmed (required).
targeting_searchCRead-onlyIdempotent
Search targeting options: interests, locations, locales, or categories.
Inputs: type (required), q, extra, limit.
updateA
Update fields of a campaign, ad set, or ad, for example budget, targeting, or name. Does not change status; use set_status. Requires explicit user confirmation.
Inputs: id (required), params (required), change_summary (required), user_confirmed (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 10 tools
Most tools have clearly distinct purposes: auth_status, insights, targeting_search, copy, and set_status are unambiguous, and update is explicitly separated from set_status. The generic list/get/create/update/delete verbs operate across several object types, so boundaries are mostly clear from descriptions but not as crisp as a fully specific set.
The set mixes bare imperative verbs (list, get, create, update, copy, delete), noun-style tools (insights), and compound snake_case names (auth_status, targeting_search, set_status). It is readable and all snake_case-compatible, but there is no single predictable naming pattern throughout.
Ten tools is well-scoped for a Meta Ads management server, covering authentication, reads, writes, status changes, copying, deletion, targeting lookup, and insights without excessive surface area. Each tool appears to earn its place.
The surface covers the core campaign, ad set, ad, and creative lifecycle plus insights, targeting, and auth, so it is largely complete for the stated purpose. Minor gaps exist, such as updating creative fields explicitly and preview/review or bulk/reporting operations, but agents can work around most of them.
Maintenance
Related MCP Connectors
Spend, campaigns, ad sets and ads on Facebook and Instagram; pause and adjust with approval
Read and manage Meta Ads campaigns, ad sets, ads, audiences, pages and Business Manager. You provide
Analyze, edit and launch Meta (Facebook and Instagram) ads from Claude, ChatGPT, Cursor or Codex. Query insights and campaign health, change budgets, bids, status and targeting with undo, bulk-launch many ads across campaigns and ad sets from a live ad's settings, and duplicate by post to keep social proof. Choose per ad account what the agent may do and what waits in the Agent Inbox for approval. Requires a paid Ads Uploader account with MCP access.
Meta Ads MCP: Facebook and Instagram reports, campaigns, creatives, audiences. Approval on writes.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceProvides read-only access to Meta Ads data and optionally creates paused ads, with safety features like OAuth and validation.-
- FlicenseNot gradedqualityCmaintenanceEnables read-only Meta Ads reporting and diagnostics, plus safe, preview-before-apply mutations such as campaign creation, duplication, targeting replacement, and attribution changes.-
- AlicenseNot gradedqualityCmaintenanceEnables Instagram insights and scoped Meta Ads operations, with campaign changes that require out-of-band approval.MIT
- AlicenseNot gradedqualityBmaintenanceEnables reading ad accounts and creating campaigns, ad sets, creatives, and ads via Meta's official Marketing API, while keeping all new objects paused and requiring the typed phrase 'ACTIVATE AND ALLOW SPEND' before anything can go live.2MIT