Skip to main content
Glama
facebook-mcp

facebook-mcp

by tannht

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
FB_APP_IDNoMeta app id, used by facebook-mcp-token to extend user tokens.
FB_PAGE_IDNoDefault Facebook Page id.
FB_APP_SECRETNoMeta app secret, used by facebook-mcp-token to extend user tokens.
FB_MCP_ENV_FILENoExplicit path to a .env file.
FACEBOOK_PAGE_IDNoAlias for FB_PAGE_ID.
FB_MCP_LOG_LEVELNoLog level (DEBUG, INFO, WARNING, etc.); logs go to stderr.INFO
FB_MCP_READ_ONLYNoSet to 1 to hide every publish/schedule/delete tool.
FB_MCP_SKIP_DOTENVNoSet to 1 to ignore all .env files.
FB_MCP_ALLOWED_DIRSNoFolders (separated by :, or ; on Windows) that local photos/videos must live in.
FB_PAGE_ACCESS_TOKENNoFacebook Page access token.
FB_USER_ACCESS_TOKENNoUser token for fb_list_pages and facebook-mcp-token.
META_GRAPH_API_VERSIONNoGraph API version.v24.0
FACEBOOK_PAGE_ACCESS_TOKENNoAlias for FB_PAGE_ACCESS_TOKEN.

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

Manage a Facebook Page through the Meta Graph API.

  • Read tools: fb_get_page_info, fb_get_recent_posts, fb_get_scheduled_posts, fb_get_page_insights, fb_get_post_insights, fb_list_pages.

  • Write tools (absent when FB_MCP_READ_ONLY=1): fb_publish_post, fb_publish_video, fb_reschedule_post, fb_publish_scheduled_now, fb_delete_post. Publishing and deleting are public and irreversible: confirm the exact content, target Page and time with the user before calling a write tool. Scheduled times are UNIX timestamps in seconds, at least 10 minutes in the future.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}

Tools

Functions exposed to the LLM to take actions

NameDescription
fb_list_pagesA

List the Facebook Pages the user manages: id, name, category, followers, tasks.

Needs a USER access token with pages_show_list (FB_USER_ACCESS_TOKEN by default). Page access tokens are never returned; use the get-token CLI to store one.

:param user_access_token: Optional user token; defaults to FB_USER_ACCESS_TOKEN.

fb_get_page_infoB

Get Page details: name, likes (fan_count), followers, link, about, category, picture.

:param page_id: Optional Page id; defaults to FB_PAGE_ID. :param page_access_token: Optional Page token; defaults to FB_PAGE_ACCESS_TOKEN.

fb_get_recent_postsA

List the Page's latest published posts with reactions, comments and shares.

:param limit: Number of posts (1-100, default 10). :param page_id: Optional Page id; defaults to FB_PAGE_ID. :param page_access_token: Optional Page token.

fb_get_scheduled_postsA

List posts scheduled but not yet published, sorted by publish time (up to 500).

:param limit: Page size per Graph request (1-100, default 100). :param page_id: Optional Page id; defaults to FB_PAGE_ID. :param page_access_token: Optional Page token.

fb_get_page_insightsB

Page analytics. Default metrics: page_post_engagements, page_daily_follows_unique, page_follows, page_views_total, page_media_view, page_total_media_view_unique, page_video_views. Metrics Meta has retired are listed in metric_errors.

:param period: day, week, days_28, month, lifetime or total_over_range. :param metrics: Optional custom metric names. :param since: Optional start (YYYY-MM-DD or UNIX seconds). :param until: Optional end (YYYY-MM-DD or UNIX seconds). :param page_id: Optional Page id; defaults to FB_PAGE_ID. :param page_access_token: Optional Page token.

fb_get_post_insightsB

Stats for one post or video: reactions/comments/shares plus reactions by type, clicks, media views, unique viewers, video views and view time.

:param post_id: Post id ("{page_id}_{post_id}") or video id. :param page_access_token: Optional Page token.

fb_publish_postA

Publish or schedule a Page post: text, text + link, or photo (local file or URL). This is public: confirm content and timing with the user first.

:param message: Post text / photo caption. :param link: Optional URL to attach (text posts only). :param photo_path: Optional local image path (jpg, png, gif, webp...). :param photo_url: Optional public image URL. Use photo_path or photo_url, not both. :param scheduled_publish_time: Optional UNIX seconds, at least 10 minutes ahead. :param page_id: Optional Page id; defaults to FB_PAGE_ID. :param page_access_token: Optional Page token.

fb_publish_videoA

Upload a local video to the Page, now or scheduled. This is public: confirm first.

as_reel=True uses the Reels API (Meta's Reels specs apply: vertical 9:16, short duration); if the Page cannot post Reels, it falls back to a regular Page video and says so in "note". as_reel=False uploads a regular Page video; files over 50 MB use chunked upload.

:param video_path: Local video path (mp4, mov, ...). :param description: Caption. :param title: Optional title (regular Page videos only; ignored for Reels). :param as_reel: Reel (default) or regular Page video. :param scheduled_publish_time: Optional UNIX seconds, at least 10 minutes ahead. :param page_id: Optional Page id; defaults to FB_PAGE_ID. :param page_access_token: Optional Page token.

fb_reschedule_postA

Change the publish time of a scheduled post or video.

:param post_id: Id of the scheduled post/video. :param new_scheduled_time_unix: New time, UNIX seconds, at least 10 minutes ahead. :param page_access_token: Optional Page token.

fb_publish_scheduled_nowA

Publish a scheduled post immediately. This is public: confirm first.

:param post_id: Id of the scheduled post. :param page_access_token: Optional Page token.

fb_delete_postA

Permanently delete a post or video from the Page. Irreversible: confirm first.

:param post_id: Id of the post/video to delete. :param page_access_token: Optional Page token.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

A4/5.0

Scored across 11 tools

Disambiguation5/5

Each tool targets a distinct resource and action: page info vs. page list, recent vs. scheduled posts, page vs. post insights, and publish/reschedule/publish-now/delete operations are clearly separated. The publish_post and publish_video tools overlap only in the broad verb but are cleanly distinguished by media type.

Naming Consistency5/5

All tools use a consistent fb_ prefix and snake_case verb_noun naming, such as fb_get_page_info, fb_publish_post, and fb_delete_post. Minor variation like fb_publish_scheduled_now is still readable and follows the same overall convention.

Tool Count5/5

Eleven tools is well-scoped for Facebook Page management, covering page discovery, post listing, publishing, scheduling, insights, and deletion without excessive surface area. Each tool appears to earn its place.

Completeness4/5

The set covers the core Page publishing lifecycle: page info/list, recent and scheduled posts, insights, text/photo/video publishing, rescheduling, immediate publishing, and deletion. Minor gaps remain around comment moderation/replies and editing existing post content, which agents may need for full social management.

Maintenance

ActivityMaintained
ResponsivenessNo recent community issues