MCP Directory

How to add Facebook/Meta Ads MCP Server to Cursor

Programmatic read & insights access to Meta (Facebook) Ads accounts, campaigns, ad sets, ads and performance data. Paste the config into ~/.cursor/mcp.json and restart Cursor.

Last updated June 14, 2026 · 332★ · stdio · apikey

Cursor config for Facebook/Meta Ads MCP Server

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

Setup steps

  1. 1Open Cursor → Settings → MCP → Add new MCP server (or edit ~/.cursor/mcp.json directly).
  2. 2Paste the Facebook/Meta Ads MCP Server config below into the "mcpServers" object.
  3. 3Fill in placeholder secrets, then save.
  4. 4Cursor reloads MCP servers automatically — check Settings → MCP for a green status dot.
  5. 5Ask Cursor to use one of Facebook/Meta Ads MCP Server's tools to confirm it's connected.

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)

What Facebook/Meta Ads MCP Server can do in Cursor

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.

Security

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 + Cursor FAQ

Where is the Cursor config file?

Cursor reads MCP servers from ~/.cursor/mcp.json. Paste the Facebook/Meta Ads MCP Server config there under the "mcpServers" key and restart the client.

Is Facebook/Meta Ads MCP Server safe to use with Cursor?

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.

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.

View repo Full Facebook/Meta Ads MCP Server page