@m8lab/mcp-facebook

MCP server for Facebook Pages — create posts, manage comments, and get insights via Claude Code/Desktop. Uses the Facebook Graph API v25.0 directly with no Facebook SDK dependency.

Requirements

• Node.js >= 18.0.0
• Facebook Page Access Token with the required permissions (see Setup)

Install

Claude Code

Add to your project's .mcp.json:

{
  "mcpServers": {
    "facebook": {
      "command": "npx",
      "args": ["-y", "@m8lab/mcp-facebook"],
      "env": {
        "FACEBOOK_PAGE_ID": "your_page_id",
        "FACEBOOK_PAGE_ACCESS_TOKEN": "your_page_access_token"
      }
    }
  }
}

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "facebook": {
      "command": "npx",
      "args": ["-y", "@m8lab/mcp-facebook"],
      "env": {
        "FACEBOOK_PAGE_ID": "your_page_id",
        "FACEBOOK_PAGE_ACCESS_TOKEN": "your_page_access_token"
      }
    }
  }
}

Available Tools

| Tool | Description | |---|---| | facebook_create_post | Publish an immediate post (text, link, picture) | | facebook_schedule_post | Schedule a post 10 min–6 months in the future | | facebook_delete_post | Permanently delete a post by ID | | facebook_get_posts | List recent Page feed posts (up to 100) | | facebook_get_comments | List comments on a specific post (up to 100) | | facebook_reply_comment | Reply to an existing comment | | facebook_hide_comment | Hide or unhide a comment | | facebook_get_insights | Retrieve Page-level analytics (views, fans, engagement) |

Environment Variables

| Variable | Description | |---|---| | FACEBOOK_PAGE_ID | Numeric ID of your Facebook Page (e.g. 123456789012345) | | FACEBOOK_PAGE_ACCESS_TOKEN | Long-lived Page Access Token with the required permissions |

How to Get Your Page Access Token

1. Go to Meta for Developers and create or open an App.
2. Under Use Cases, add Pages and request the following permissions:
   • pages_manage_posts — create, schedule, delete posts
   • pages_read_engagement — read posts and comments
   • pages_manage_engagement — reply to and hide comments
   • pages_read_user_content — read comments
   • read_insights — access Page analytics
3. In the Graph API Explorer:
   • Select your App and your Page under User or Page.
   • Click Generate Access Token and approve all required permissions.
   • Use the token expander in Access Token Debugger to convert it to a long-lived token (~60 days) or generate a never-expiring System User token via Business Manager.
4. Your Page ID is the number in your Page's About section or visible in the Graph API Explorer dropdown.

App Review Note: For a live app serving users other than yourself and your test users, Facebook requires App Review for pages_manage_posts and related permissions. During development you can use the token for your own pages without review.

Development

# Clone the repo
git clone https://github.com/lmtNoLimit/mcp-facebook.git
cd mcp-facebook

# Install dependencies
npm install

# Type check
npm run typecheck

# Build
npm run build

# Watch mode
npm run dev

Copy .env.example to .env and fill in your credentials to run locally:

cp .env.example .env
# Edit .env with your FACEBOOK_PAGE_ID and FACEBOOK_PAGE_ACCESS_TOKEN
node dist/index.js

License

MIT — see LICENSE