io.github.IvanBBaev/facebook-mcp

Facebook Pages MCP server for the Meta Graph API — publishing, insights, moderation, messaging

Connect this server

Add this to your MCP client config — claude_desktop_config.json (Claude Desktop) or .cursor/mcp.json (Cursor).Suits: Claude Desktop · Cursor.

{
  "mcpServers": {
    "facebook-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@ivanbaev/facebook-mcp@0.8.0"
      ],
      "env": {
        "FB_SYSTEM_TOKEN": "<your FB_SYSTEM_TOKEN>",
        "FB_ACCESS_TOKEN": "<your FB_ACCESS_TOKEN>",
        "FB_PAGE_TOKEN": "<your FB_PAGE_TOKEN>",
        "FB_APP_SECRET": "<your FB_APP_SECRET>",
        "FB_API_VERSION": "v26.0",
        "FB_ADS_API_VERSION": "v26.0",
        "FB_REQUEST_TIMEOUT_MS": "60000",
        "FB_HOST_CONCURRENCY": "4",
        "FB_MAX_RESULT_CHARS": "25000",
        "FB_WRITE_MODE": "plan",
        "FB_CONFIRM_TOKEN": "<your FB_CONFIRM_TOKEN>",
        "FB_TRANSPORT": "stdio",
        "FB_HTTP_TOKEN": "<your FB_HTTP_TOKEN>",
        "FB_HTTP_PORT": "3000",
        "FB_LOG_LEVEL": "info"
      }
    }
  }
}

Environment variables

FB_SYSTEM_TOKENsecretSystem-user access token (Business Manager). Takes precedence over FB_ACCESS_TOKEN and FB_PAGE_TOKEN when several are set.
FB_ACCESS_TOKENsecretPrimary user access token. At least one of FB_SYSTEM_TOKEN, FB_ACCESS_TOKEN or FB_PAGE_TOKEN must be set.
FB_PAGE_TOKENsecretLong-lived Page access token used as a fallback credential when no user or system-user token is configured. It belongs to exactly one Page, so set FB_PAGE_ID to that Page ID alongside it (the doctor / facebook_whoami reports it as the acting Page); a Page token without its Page ID is bound to nothing.
FB_APP_SECRETsecretMeta app secret. When set, appsecret_proof is attached to every call so a stolen bare token cannot be used on its own.
FB_API_VERSIONGraph API version to target. Defaults to the tested pinned version; other values are accepted verbatim as an escape hatch but are not tested.
FB_ADS_API_VERSIONMarketing API version the ads tools target (ad accounts, campaigns, ad sets, ads, insights, async reports). The Marketing API retires versions on its own, shorter schedule, so it is pinned separately from FB_API_VERSION. Other values are accepted verbatim as an escape hatch but are not tested.
FB_REQUEST_TIMEOUT_MSPer-request timeout in milliseconds; integer in [1, 600000].
FB_HOST_CONCURRENCYMaximum number of in-flight requests per Graph host; integer in [1, 64].
FB_MAX_RESULT_CHARSCharacter budget applied by the result shaper before a tool result is truncated; integer in [500, 10000000].
FB_WRITE_MODEWrite gating mode: plan (validating dry-run preview, the default) or apply. It never covers the irreversible and spend tiers, which always need a per-call apply plus a plan_id.
FB_CONFIRM_TOKENsecretOperator confirmation token for out-of-band approval of irreversible or spend actions. The server prompts through MCP elicitation where the client supports it; otherwise the caller passes this value as the confirm_token tool argument. At least 16 characters — a shorter value fails startup; mint one with openssl rand -hex 32.
FB_TRANSPORTTransport protocol: stdio (default) or http. The http transport binds 127.0.0.1 only and fails closed without FB_HTTP_TOKEN.
FB_HTTP_TOKENsecretBearer token guarding the HTTP transport; required when FB_TRANSPORT=http (the server refuses to start without it). At least 16 characters — a shorter value is refused (under stdio it is dropped with a warning); mint one with openssl rand -hex 32.
FB_HTTP_PORTPort for the HTTP transport (loopback only); used when FB_TRANSPORT=http. Integer in [1, 65535].
FB_LOG_LEVELStderr log verbosity: debug, info, warn or error. Logs never go to stdout — that is the stdio protocol channel.

A starting point — check the repository for exact arguments and setup. Restart your client after editing the config.

Category: Developer Tools
Version: 0.8.0
Registry: active
Published: 10/28/2026

Browse all Developer Tools →

io.github.IvanBBaev/servicenow-mcp-ai

IvanBBaev

ServiceNow MCP server — 100 tools over the full REST surface, every auth method, flows, diagrams.

Developer ToolsAdded 1 week ago

io.github.IvanBBaev/x-mcp-ai

IvanBBaev

Safety-first X (Twitter) API v2 MCP server: 41 typed tools across 12 packages, policy-gated.

Developer ToolsAdded 2 months ago

io.github.IvandeMurard/paris-compass-mcp

IvandeMurard

Paris commercial premises from open data: shopfront history, street turnover, sourced figures.

Developer ToolsAdded 1 month ago

io.github.ivangr1/walletap

ivangr1

Issue and manage Apple Wallet & Google Wallet passes from any AI assistant.

Developer ToolsAdded 7 months ago

io.github.ivanlai/primer-mcp

ivanlai

A Jira-lite MCP server that guides planning-first workflows for AI-assisted development.

Developer ToolsAdded 1 month ago

AI Game Developer: MCP for Unity, Unreal and Godot

IvanMurzak

Make games with AI: one MCP server that connects your agent to Unity, Unreal and Godot editors.

Developer ToolsAdded 1 week ago

Add the badge to your site

Show visitors that io.github.IvanBBaev/facebook-mcp is listed here — it’s also the link we check for a free listing.

HTML — for your website

<a href="https://serverdex.io/server/io-github-ivanbbaev-facebook-mcp?utm_source=badge"><img src="https://serverdex.io/brand/badge.svg" alt="io.github.IvanBBaev/facebook-mcp — listed on Serverdex" width="123" height="40" loading="lazy"></a>

Recommended. A dofollow link from your own domain is the one that counts for search engines, and it's the link we check for a free listing.

Markdown — for your README

[![io.github.IvanBBaev/facebook-mcp — listed on Serverdex](https://serverdex.io/brand/badge.svg)](https://serverdex.io/server/io-github-ivanbbaev-facebook-mcp?utm_source=badge)

Nice for visibility, but GitHub marks README links nofollow, so it doesn't pass authority. Use the HTML badge on your site as well.