Facebook MCP

What you can do with it

We have not written a plain-language summary for this one yet. Below are the facts we read from the registry.

• Connection: Runs on your computer
• Transport: stdio
• Category: Marketing & social media
• You need to fill in: FB_SYSTEM_TOKEN, FB_ACCESS_TOKEN, FB_PAGE_TOKEN, FB_APP_SECRET, FB_CONFIRM_TOKEN, FB_HTTP_TOKEN

Install

Pick the AI app you use, then copy the settings.

You need

• npmNode.js installed (for the npx command)

Which app do you use?

{
  "mcpServers": {
    "facebook": {
      "command": "npx",
      "args": [
        "-y",
        "@ivanbaev/facebook-mcp"
      ],
      "env": {
        "FB_SYSTEM_TOKEN": "your-value",
        "FB_ACCESS_TOKEN": "your-value",
        "FB_PAGE_TOKEN": "your-value",
        "FB_APP_ID": "your-value",
        "FB_APP_SECRET": "your-value",
        "FB_PAGE_ID": "your-value",
        "FB_API_VERSION": "your-value",
        "FB_ADS_API_VERSION": "your-value",
        "FB_REQUEST_TIMEOUT_MS": "your-value",
        "FB_HOST_CONCURRENCY": "your-value",
        "FB_MAX_RESULT_CHARS": "your-value",
        "FB_WRITE_MODE": "your-value",
        "FB_CONFIRM_TOKEN": "your-value",
        "FB_MEDIA_DIR": "your-value",
        "FB_JOURNAL_PATH": "your-value",
        "FB_ACTIVITY_STATE_PATH": "your-value",
        "FB_EXPORT_DIR": "your-value",
        "FB_TOOL_PACKAGES": "your-value",
        "FB_PACKAGES_DENY": "your-value",
        "FB_PACKAGES_READONLY": "your-value",
        "FB_TRANSPORT": "your-value",
        "FB_HTTP_TOKEN": "your-value",
        "FB_HTTP_PORT": "your-value",
        "FB_AD_ACCOUNT_ID": "your-value",
        "FB_ADS_BUDGET_CEILING": "your-value",
        "FB_ADS_CAMPAIGN_SPEND_CAP_MAX": "your-value",
        "FB_LOG_LEVEL": "your-value"
      }
    }
  }
}

claude mcp add facebook --env FB_SYSTEM_TOKEN=your-value --env FB_ACCESS_TOKEN=your-value --env FB_PAGE_TOKEN=your-value --env FB_APP_ID=your-value --env FB_APP_SECRET=your-value --env FB_PAGE_ID=your-value --env FB_API_VERSION=your-value --env FB_ADS_API_VERSION=your-value --env FB_REQUEST_TIMEOUT_MS=your-value --env FB_HOST_CONCURRENCY=your-value --env FB_MAX_RESULT_CHARS=your-value --env FB_WRITE_MODE=your-value --env FB_CONFIRM_TOKEN=your-value --env FB_MEDIA_DIR=your-value --env FB_JOURNAL_PATH=your-value --env FB_ACTIVITY_STATE_PATH=your-value --env FB_EXPORT_DIR=your-value --env FB_TOOL_PACKAGES=your-value --env FB_PACKAGES_DENY=your-value --env FB_PACKAGES_READONLY=your-value --env FB_TRANSPORT=your-value --env FB_HTTP_TOKEN=your-value --env FB_HTTP_PORT=your-value --env FB_AD_ACCOUNT_ID=your-value --env FB_ADS_BUDGET_CEILING=your-value --env FB_ADS_CAMPAIGN_SPEND_CAP_MAX=your-value --env FB_LOG_LEVEL=your-value -- npx -y @ivanbaev/facebook-mcp

{
  "mcpServers": {
    "facebook": {
      "command": "npx",
      "args": [
        "-y",
        "@ivanbaev/facebook-mcp"
      ],
      "env": {
        "FB_SYSTEM_TOKEN": "your-value",
        "FB_ACCESS_TOKEN": "your-value",
        "FB_PAGE_TOKEN": "your-value",
        "FB_APP_ID": "your-value",
        "FB_APP_SECRET": "your-value",
        "FB_PAGE_ID": "your-value",
        "FB_API_VERSION": "your-value",
        "FB_ADS_API_VERSION": "your-value",
        "FB_REQUEST_TIMEOUT_MS": "your-value",
        "FB_HOST_CONCURRENCY": "your-value",
        "FB_MAX_RESULT_CHARS": "your-value",
        "FB_WRITE_MODE": "your-value",
        "FB_CONFIRM_TOKEN": "your-value",
        "FB_MEDIA_DIR": "your-value",
        "FB_JOURNAL_PATH": "your-value",
        "FB_ACTIVITY_STATE_PATH": "your-value",
        "FB_EXPORT_DIR": "your-value",
        "FB_TOOL_PACKAGES": "your-value",
        "FB_PACKAGES_DENY": "your-value",
        "FB_PACKAGES_READONLY": "your-value",
        "FB_TRANSPORT": "your-value",
        "FB_HTTP_TOKEN": "your-value",
        "FB_HTTP_PORT": "your-value",
        "FB_AD_ACCOUNT_ID": "your-value",
        "FB_ADS_BUDGET_CEILING": "your-value",
        "FB_ADS_CAMPAIGN_SPEND_CAP_MAX": "your-value",
        "FB_LOG_LEVEL": "your-value"
      }
    }
  }
}

{
  "servers": {
    "facebook": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@ivanbaev/facebook-mcp"
      ],
      "env": {
        "FB_SYSTEM_TOKEN": "your-value",
        "FB_ACCESS_TOKEN": "your-value",
        "FB_PAGE_TOKEN": "your-value",
        "FB_APP_ID": "your-value",
        "FB_APP_SECRET": "your-value",
        "FB_PAGE_ID": "your-value",
        "FB_API_VERSION": "your-value",
        "FB_ADS_API_VERSION": "your-value",
        "FB_REQUEST_TIMEOUT_MS": "your-value",
        "FB_HOST_CONCURRENCY": "your-value",
        "FB_MAX_RESULT_CHARS": "your-value",
        "FB_WRITE_MODE": "your-value",
        "FB_CONFIRM_TOKEN": "your-value",
        "FB_MEDIA_DIR": "your-value",
        "FB_JOURNAL_PATH": "your-value",
        "FB_ACTIVITY_STATE_PATH": "your-value",
        "FB_EXPORT_DIR": "your-value",
        "FB_TOOL_PACKAGES": "your-value",
        "FB_PACKAGES_DENY": "your-value",
        "FB_PACKAGES_READONLY": "your-value",
        "FB_TRANSPORT": "your-value",
        "FB_HTTP_TOKEN": "your-value",
        "FB_HTTP_PORT": "your-value",
        "FB_AD_ACCOUNT_ID": "your-value",
        "FB_ADS_BUDGET_CEILING": "your-value",
        "FB_ADS_CAMPAIGN_SPEND_CAP_MAX": "your-value",
        "FB_LOG_LEVEL": "your-value"
      }
    }
  }
}

Your choice stays on this device in a cookie; no account needed.

Values you fill in

• FB_SYSTEM_TOKEN secret env
  System-user access token (Business Manager). Takes precedence over FB_ACCESS_TOKEN and FB_PAGE_TOKEN when several are set.
• FB_ACCESS_TOKEN secret env
  Primary user access token. At least one of FB_SYSTEM_TOKEN, FB_ACCESS_TOKEN or FB_PAGE_TOKEN must be set.
• FB_PAGE_TOKEN secret env
  Long-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…
• FB_APP_ID env
  Meta app ID; combined with FB_APP_SECRET it forms the app access token used to authorize /debug_token inspection.
• FB_APP_SECRET secret env
  Meta app secret. When set, appsecret_proof is attached to every call so a stolen bare token cannot be used on its own.
• FB_PAGE_ID env
  Default Facebook Page ID, used when a tool call omits an explicit profile argument. Required when FB_PAGE_TOKEN is the only credential: it names the Page that token belongs to.
• FB_API_VERSION env
  Graph 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_VERSION env
  Marketing 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…
• FB_REQUEST_TIMEOUT_MS env
  Per-request timeout in milliseconds; integer in [1, 600000].
• FB_HOST_CONCURRENCY env
  Maximum number of in-flight requests per Graph host; integer in [1, 64].
• FB_MAX_RESULT_CHARS env
  Character budget applied by the result shaper before a tool result is truncated; integer in [500, 10000000].
• FB_WRITE_MODE env
  Write 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_TOKEN secret env
  Operator 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…
• FB_MEDIA_DIR env
  Directory permitted for local media uploads. Unset means URL-only uploads and no local file access at all.
• FB_JOURNAL_PATH env
  Path to the append-only write journal. Defaults to the XDG/%APPDATA% state path; the file is created owner-only (0600) and rotates by size.
• FB_ACTIVITY_STATE_PATH env
  Path to the small JSON file where facebook_get_activity_since keeps, per Page, the horizon of the last complete read. Defaults to the XDG/%APPDATA% state path next to the journal; the file holds Page…
• FB_EXPORT_DIR env
  Directory where the insights tools write a CSV or JSON file when called with `output`. Defaults to `exports/` under the XDG/%APPDATA% state path. Files are written atomically and owner-only (0600) an…
• FB_TOOL_PACKAGES env
  Comma-separated tool packages or profiles to expose (e.g. core,posts,reader, or the profiles core|all|reader|publisher|moderator|ads). Omit for the default profile, which excludes ads.
• FB_PACKAGES_DENY env
  Comma-separated packages OR profiles to exclude even when FB_TOOL_PACKAGES enables them; deny wins over allow. Profile names expand here exactly as they do in FB_TOOL_PACKAGES, and a profile beats a…
• FB_PACKAGES_READONLY env
  Comma-separated packages OR profiles whose write tools are not registered at all; the read tools of those packages stay available. Profile names expand as they do in FB_TOOL_PACKAGES, so FB_PACKAGES_…
• FB_TRANSPORT env
  Transport protocol: stdio (default) or http. The http transport binds 127.0.0.1 only and fails closed without FB_HTTP_TOKEN.
• FB_HTTP_TOKEN secret env
  Bearer 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…
• FB_HTTP_PORT env
  Port for the HTTP transport (loopback only); used when FB_TRANSPORT=http. Integer in [1, 65535].
• FB_AD_ACCOUNT_ID env
  Default ad account ID (act_… or the bare numeric id) for the opt-in ads package.
• FB_ADS_BUDGET_CEILING env
  Hard ceiling for any ads budget write, in minor units of the ad account's own currency (e.g. cents for USD). Non-negative integer; a write above it is refused. No currency conversion: size it for the…
• FB_ADS_CAMPAIGN_SPEND_CAP_MAX env
  Largest campaign spend_cap (the lifetime total a campaign may spend) that an ads write may set, in minor units of the ad account's own currency. Non-negative integer; a cap above it is refused, never…
• FB_LOG_LEVEL env
  Stderr log verbosity: debug, info, warn or error. Logs never go to stdout — that is the stdio protocol channel.

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

What it can do

Runs on your computer; the tool list appears in your AI app after you install it.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 6, 2026

• ✓ Pass

  Maker matches the repo

  The registry name was verified with the GitHub account IvanBBaev, which owns the repo

• … Not checked yet

  Still maintained

  We have not read this repo from GitHub yet

• … Not checked yet

  Has a licence

  We have not read this repo from GitHub yet

• – Not applicable

  Endpoint responds

  This one runs on your computer; there is no internet endpoint

• – Not applicable

  Sign-in with OAuth

  Runs on your computer and uses local settings instead

• … Not checked yet

  No hidden instructions in tool descriptions

  Runs on your computer; we can only read tool lists from internet endpoints

Compared with others in Marketing & social mediai

• More stars than 0% of the other 2965 servers in this category
• Published to the registry more recently than 79% of the other 2965 servers in this category
• Basic checks equal to or better than 100% of the other 2965 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Alternatives

Servers in the same category from other makers, sorted by stars.

Reading a card:★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

README from the maker

   FB_APP_ID='<app id>' FB_APP_SECRET='<app secret>' \

   npx -y @ivanbaev/facebook-mcp doctor