MCP Directory

How to add Facebook/Meta Ads MCP Server to Claude Desktop

Programmatic read & insights access to Meta (Facebook) Ads accounts, campaigns, ad sets, ads and performance data. Paste the config into ~/Library/Application Support/Claude/claude_desktop_config.json and restart Claude Desktop.

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

Claude Desktop 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 Claude Desktop → Settings → Developer → Edit Config (this opens ~/Library/Application Support/Claude/claude_desktop_config.json).
  2. 2Paste the Facebook/Meta Ads MCP Server config below under the top-level "mcpServers" key.
  3. 3Fill in any placeholder secrets (API keys, paths) in the snippet.
  4. 4Save the file, then fully quit and reopen Claude Desktop.
  5. 5Open a chat and confirm Facebook/Meta Ads MCP Server's tools appear under the 🔌 tools menu.

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 Claude Desktop

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 + Claude Desktop FAQ

Where is the Claude Desktop config file?

Claude Desktop reads MCP servers from ~/Library/Application Support/Claude/claude_desktop_config.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 Claude Desktop?

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