MCP Directory

Facebook/Meta Ads MCP Server

Programmatic read & insights access to Meta (Facebook) Ads accounts, campaigns, ad sets, ads and performance data.

Unverified
stdio (local)
API key
Stale
Python
View repo 332 Website

Add to your client

Copy the config for your MCP client and paste it into its config file.

Install / run
pip install -r requirements.txt

Paste into ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "facebook-meta-ads-mcp-server": {
      "command": "python",
      "args": [
        "/path/to/your/fb-ads-mcp-server/server.py",
        "--fb-token",
        "YOUR_META_ACCESS_TOKEN"
      ]
    }
  }
}

Step-by-step guides: Add to Claude Desktop · Add to Cursor · Add to Windsurf

Before you start

  • Python 3.10+
  • Dependencies from requirements.txt (mcp >=1.6.0, requests >=2.32.3)
  • A Meta User Access Token with the necessary permissions (e.g. ads_read)

About Facebook/Meta Ads MCP Server

This MCP server provides an interface to the Meta (Facebook) Ads platform, giving MCP-compatible clients such as Cursor and Claude Desktop programmatic access to Meta Ads data. It supports reading ad accounts, campaigns, ad sets, ads and creatives; fetching collections of objects scoped to an account, campaign or ad set; retrieving performance insights at the account, campaign, ad set and ad levels; paginating through results; and inspecting account/ad-set change history. It runs locally over stdio and authenticates with a Meta User Access Token supplied via the --fb-token argument.

Tools & capabilities (21)

list_ad_accounts

Lists ad accounts linked to the token.

get_details_of_ad_account

Retrieves details for a specific ad account.

get_campaign_by_id

Retrieves details for a specific campaign.

get_adset_by_id

Retrieves details for a specific ad set.

get_ad_by_id

Retrieves details for a specific ad.

get_ad_creative_by_id

Retrieves details for a specific ad creative.

get_adsets_by_ids

Retrieves details for multiple ad sets by their IDs.

get_campaigns_by_adaccount

Retrieves campaigns within an ad account.

get_adsets_by_adaccount

Retrieves ad sets within an ad account.

get_ads_by_adaccount

Retrieves ads within an ad account.

get_adsets_by_campaign

Retrieves ad sets within a campaign.

get_ads_by_campaign

Retrieves ads within a campaign.

get_ads_by_adset

Retrieves ads within an ad set.

get_ad_creatives_by_ad_id

Retrieves creatives associated with an ad.

get_adaccount_insights

Retrieves performance insights for an ad account.

get_campaign_insights

Retrieves performance insights for a campaign.

get_adset_insights

Retrieves performance insights for an ad set.

get_ad_insights

Retrieves performance insights for an ad.

fetch_pagination_url

Fetches data from a pagination URL (e.g., from insights).

get_activities_by_adaccount

Retrieves change history for an ad account.

get_activities_by_adset

Retrieves change history for an ad set.

When to use it

  • Pull Meta Ads performance insights at the account, campaign, ad set or ad level directly from an AI assistant.
  • List and inspect ad accounts, campaigns, ad sets, ads and creatives without leaving Cursor or Claude Desktop.
  • Audit recent changes to an ad account or ad set via its activity/change history.
  • Page through large insight result sets using the returned pagination URLs.

Security notes

Requires a Meta User Access Token (e.g. with the `ads_read` permission), passed via the `--fb-token` command-line argument and stored in the MCP client config. Treat this token as a secret. If the token expires you must generate a new one and update the client configuration. The optional GoMarble one-click installer can create a token on your behalf via GoMarble's server; per the README GoMarble does not store the token — it is saved locally on your machine.

Facebook/Meta Ads MCP Server FAQ

How do I authenticate?

Provide a Meta User Access Token (with permissions such as ads_read) via the --fb-token command-line argument in your MCP client configuration. You can generate the token through the Meta Developer portal, or use the optional GoMarble one-click installer to have a token created on your behalf.

What happens when my token expires?

If your Meta access token expires you'll need to generate a new one and update the MCP client configuration file with the new token to continue using the tools.

Can it modify campaigns, or is it read-only?

The documented tools cover reading objects, fetching collections, performance insights, pagination, and change history. The README describes it as enabling access to Meta Ads data and management features; refer to the docstrings in server.py for the full argument list of each tool.

Is there an easier installation path?

Yes. GoMarble offers a one-click installer at https://gomarble.ai/mcp, and the server can be installed for Claude Desktop automatically via Smithery using 'npx -y @smithery/cli install @gomarble-ai/facebook-ads-mcp-server --client claude'.

#facebook-ads#meta-ads#advertising#marketing#analytics#insights#python

Alternatives to Facebook/Meta Ads MCP Server

Compare all alternatives →
Memory (Knowledge Graph)
AI, Data & Knowledge
74k

Official MCP server providing persistent, file-backed knowledge-graph memory across sessions.

Verified
stdio (local)
No auth
TypeScript
9 tools
Updated 5 months agoRepo
Sequential Thinking
AI, Data & Knowledge
62k

Structured step-by-step reasoning tool for breaking problems into revisable thought sequences.

Verified
stdio (local)
No auth
TypeScript
1 tool
Updated 6 months agoRepo
AWS Knowledge MCP
AI, Data & Knowledge
7.0k

Fully managed remote server for AWS docs, blogs, What's-New and Well-Architected guidance — no key.

Verified
HTTP (remote)
No auth
Hosted
6 tools
Updated 5 months agoRepo

Compare Facebook/Meta Ads MCP Server with:

vs Memory (Knowledge Graph)vs Sequential Thinkingvs AWS Knowledge MCPvs MCP Server Chart