Facebook MCP server for your agent

To give Claude, Cursor, ChatGPT or another MCP client Facebook data, add Apify's hosted MCP server with the Actors ticked below as tools (6 by default); the URL is in every config. Sign in with your Apify account or pass an API token; each call runs the Actor and returns Facebook records to the agent.

One click, signs in with Apify on first use:

Add to Cursor Add to VS Code

Any other client, one command (writes the config for 25+ agents, including Windsurf, Zed, Cline and Goose):

npx add-mcp "https://mcp.apify.com/?tools=fetch-actor-details,nimbryxo-studio/facebook-business-page-finder-by-keyword-and-city,nimbryxo-studio/facebook-timeline-posts-and-reel-transcript,vexaloom-labs/facebook-post-and-group-comment-thread-extractor,nimbryxo-studio/facebook-marketplace-listing-and-price-extractor,vexaloom-labs/facebook-group-feed-and-engagement-extractor,vexaloom-labs/facebook-event-details-and-new-event-monitor" --name apify-facebook
Catalogue Actors
10
In this bundle
6
Official API
Limited
Data checked
2026-11-12

Config for your client

Claude Code configterminal or .mcp.json

claude mcp add --transport http apify-facebook "https://mcp.apify.com/?tools=fetch-actor-details,nimbryxo-studio/facebook-business-page-finder-by-keyword-and-city,nimbryxo-studio/facebook-timeline-posts-and-reel-transcript,vexaloom-labs/facebook-post-and-group-comment-thread-extractor,nimbryxo-studio/facebook-marketplace-listing-and-price-extractor,vexaloom-labs/facebook-group-feed-and-engagement-extractor,vexaloom-labs/facebook-event-details-and-new-event-monitor"
  1. Run the command in your project folder. Add --scope user to make it available in every project.
  2. Start Claude Code, type /mcp, pick the server and sign in to Apify in the browser window.
  3. No browser sign-in? Add --header "Authorization: Bearer YOUR_APIFY_TOKEN" to the command instead.

Sign-in: OAuth sign-in on first use, or a token header.

Validated, not executed: 7 of 7 checks pass
  • Uses Apify's hosted MCP endpoint over HTTPS
  • The tools parameter lists exactly the chosen Actors as owner/name
  • JSON configs parse and use the client's top-level key and the same URL
  • Codex TOML has a [mcp_servers.<name>] table with url and bearer_token_env_var
  • CLI commands quote the same URL and use the streamable HTTP transport
  • One-click install links decode back to the same URL and carry no token
  • Only placeholders, no real token

Official API or an Actor?

Facebook has an official API with limited access

The Graph API exposes data for apps and Pages you manage, plus some public Page data with approved permissions. It is not a general crawler of public posts.

No per-call fee is published for standard Graph API use; access depends on app review.

Permissions, app review and rate limits apply. Many public-content use cases are not supported.

Meta Graph API documentation

Use public data, respect Meta's terms and do not collect private profile data; not legal advice.

Which Actor for which job

  • Facebook Page & Profile Finder by Keyword or URL finds Page or profile records from a search term or URL; it returns entityType and facebookUrl.
  • Facebook Public Follower & Following Snapshot Tool collects publicly accessible follower or following lists with summary records; it returns collectionName and profileUrl.
  • Facebook Business Page Finder by Keyword & City locates business Pages for local research; it returns address and category.
  • Facebook Business Page Recommendation & Review Scraper collects recommendations, reviews and page-summary records; it returns isRecommended and text.
  • Facebook Event Details & New-Event Monitor Scraper collects public event details and monitor-filtered results; it returns formatted_date and location_name.
  • Facebook Group Feed & Engagement Extractor collects public group posts and engagement; it returns text and commentsCount.
  • Facebook Marketplace Listing & Price Extractor collects listing records for product and location comparisons; it returns price and condition.

Where it stops

An Apify API token authorizes the token-based MCP connection to Apify; it does not complete Facebook OAuth or grant Facebook Page permissions. Recipe for Agents has not authenticated to Apify or Facebook for you. Public access limits still apply: follower pagination may be incomplete, and private or empty groups may produce status records rather than posts. Use the Graph API for apps and Pages you manage, or public Page access covered by approved permissions; it is not a general crawler of public posts.

Every Facebook Actor in the catalogue

ActorReturnsFieldsStore priceLast update
Facebook Page Photo Gallery & Engagement Scraper One row per public Facebook photo with image and thumbnail links, caption, timestamp, reaction breakdown, comments, shares, tagged people… Fields include photoId, photoUrl, imageUrl. 44 $0.99 per 1,000 results 2026-10-24
Facebook Page & Profile Finder by Keyword or URL Structured Facebook Page or profile records: name, ID, URL, verified badge, entity type, category, contact details, followers, ratings… Fields include pageName, facebookUrl, entityType. 10 $0.99 per 1,000 results 2026-11-10
Facebook Public Follower & Following Snapshot Tool Facebook Page/Profile follower and following rows collected through public cursor pagination, plus per-target summaries with the actual… Fields include name, profileId, profileTypename. 10 $0.99 per 1,000 results 2026-10-29
Facebook Business Page Finder by Keyword & City One record per Facebook business Page with identity, public contact details, social links, followers, recommendation metrics, open status… Fields include pageName, category, address. 25 $0.99 per 1,000 results 2026-10-22
Facebook Business Page Recommendation & Review Scraper Review rows with recommendation status, author details, reactions, tags, comments and owner replies, plus one page-summary row per page… Fields include pageName, authorName, isRecommended. 30 $0.99 per 1,000 results 2026-10-22
Facebook Event Details & New-Event Monitor Scraper Public Facebook event records with dates, venue and GPS (when exposed), hosts, ticket data, recurring occurrences, online links and… Fields include event_id, name, formatted_date. 7 $0.99 per 1,000 results 2026-10-23
Facebook Group Feed & Engagement Extractor Dataset of public Facebook group posts with text, media, reactions, comment threads, reshares and optional group profile data. Rows for… Fields include postId, authorName, text. 7 $0.99 per 1,000 results 2026-10-26
Facebook Marketplace Listing & Price Extractor One JSON object per Facebook Marketplace listing. Canonical groups: identity and provenance (id, listingUrl, sourceUrl, sourceType… Fields include title, price, city. 75 $0.99 per 1,000 results 2026-10-29
Facebook Post & Group Comment Thread Extractor One record per Facebook comment or reply: text, author details, timestamp, per-reaction-type counts, reply/thread context, attachment and… Fields include profileName, text, date. 12 $0.99 per 1,000 results 2026-10-18
Facebook Timeline Posts & Reel Transcript Extractor One record per Facebook post, reel or video: text, author, reactions by type, comment and share counts, video views, media links, link… Fields include postId, postType, text. 14 $0.99 per 1,000 results 2026-10-21

Call these Actors from code: the Facebook data API page

Store links: facebook-page-photo-gallery-and-engagement-scraper, facebook-page-and-profile-finder-by-keyword-or-url, facebook-public-follower-and-following-snapshot, facebook-business-page-finder-by-keyword-and-city, facebook-business-page-recommendation-and-review, facebook-event-details-and-new-event-monitor, facebook-group-feed-and-engagement-extractor, facebook-marketplace-listing-and-price-extractor, facebook-post-and-group-comment-thread-extractor, facebook-timeline-posts-and-reel-transcript

Facebook recipes for n8n

Troubleshooting

Why does the client say Unauthorized or invalid token?

Every Apify Actor tool needs a signed-in Apify account. Reconnect the server so the OAuth sign-in runs again, or switch to the token variant: an Authorization: Bearer header with an API token from Apify Console, Settings, API and integrations. For a local server the token must be in the server's own env block, not only in your shell.

Source: Apify MCP server README

Why did my agent's tool list change after an update?

Without a tools parameter Apify's server loads its default tool set, which changes between releases. The URLs on this site pin the tools with ?tools=, so the agent always gets the same Actor tool plus fetch-actor-details. Apify's README gives the same advice for production.

Source: Apify MCP server README

What happens when the agent sends input the Actor rejects?

The server answers with the Actor's input schema, so the agent can fix the arguments and call again. The fetch-actor-details tool in every scoped URL lets it read that schema before the first call.

Source: Apify MCP server README

Claude Code shows Needs authentication. Why?

The server is added but not signed in. Type /mcp in an interactive session and authenticate, or run claude mcp login with the server name. Headless runs with claude -p cannot complete OAuth, so sign in once interactively or use the --header token variant.

Source: Claude Code MCP documentation

Claude Code warns that a tool result is too large. What can I change?

Claude Code warns above 10,000 tokens of tool output and caps it at 25,000 by default (MAX_MCP_OUTPUT_TOKENS raises it). Ask the agent for fewer results per call, for example a lower result limit for the Actor.

Source: Claude Code MCP documentation

Cursor does not show the server's tools. What should I check?

Open the Output panel and pick MCP Logs to see the connection error. A deeplink install that does nothing usually means an older Cursor build; update it or paste the JSON into mcp.json by hand.

Source: Cursor MCP documentation

Every fix in one place

Questions

How do I get Facebook Page data into Claude?

Configure Apify MCP in your Claude client and complete Apify authentication using the method required by that configuration. Select Facebook Page & Profile Finder by Keyword or URL for Page discovery, then choose a photo, review or event Actor for the next collection job.

Can you read private Facebook groups with this connection?

Facebook Group Feed & Engagement Extractor covers public group posts. Private or empty groups may return a status message and public group metadata rather than post content.

Can you get a complete list of Facebook followers?

Facebook Public Follower & Following Snapshot Tool collects lists through public cursor pagination, so complete coverage is not guaranteed. Ask Claude to inspect the returned summary for pagination completeness and access state before describing the list as complete.

Do I need Facebook OAuth or an Apify token?

The token-based MCP configurations require your Apify API token and do not perform Facebook OAuth. For Graph API access to managed Pages or permission-controlled public Page information, use the applicable Facebook authorization process instead.