Facebook / Meta MCP Server (was-fb-mcp)

Shareable Facebook & Meta Graph API Model Context Protocol (MCP) server. Exposes 10 powerful tools to manage Facebook Pages, Posts, Comments, Ad Accounts, Campaigns, Insights, and execute any raw Graph API request from your favorite AI coding assistant (Claude Desktop, Cursor, Google Antigravity, VS Code, Zed).

Prerequisites

• Node.js 18+

• A Facebook / Meta Account & Meta Developer App

• A Facebook User Access Token or Page Access Token (generated via Meta for Developers Graph API Explorer)

Related MCP server: Facebook MCP Server

Quick Start — 3 Steps

Step 1 — Get credentials

1. Go to Meta for Developers — Graph API Explorer.

2. Select your App and click Generate Access Token.

3. Grant permissions such as pages_show_list, pages_read_engagement, pages_manage_posts, ads_read, read_insights.

Step 2 — Connect

Run the interactive setup command in your terminal:

npx -y github:was-member-keramat/was-fb-mcp auth

Paste your Access Token when prompted. Credentials will be securely saved locally to ~/.was-fb-mcp/config.json with restricted file permissions (0600).

Step 3 — Add to your AI Client

Add the following 4 lines to your AI tool's MCP configuration (claude_desktop_config.json, mcp_config.json, etc.):

{
  "mcpServers": {
    "Facebook MCP": {
      "command": "npx",
      "args": ["-y", "github:was-member-keramat/was-fb-mcp"]
    }
  }
}

What you can ask the AI

Here are example prompts you can use with your AI assistant:

• Discovery: "List all Facebook Pages I manage."

• Content Creation: "Publish a new post to my Page with ID 100123456 saying 'Hello World!'."

• Feed & Comments: "Show the latest 10 posts on my Page feed and list the comments on the top post."

• Interaction: "Reply to comment ID 987654321 with 'Thank you for your feedback!'."

• Ads Management: "List my Meta Ad Accounts and show active campaigns in act_123456789."

• Analytics: "Get post engagement insights for Page 100123456."

• Universal Access: "Use fb_api to GET v19.0/me/photos."

All Tools (10 Total)

CLI Commands

# Connect / re-connect credentials
npx -y github:was-member-keramat/was-fb-mcp auth

# Check saved configuration status
npx -y github:was-member-keramat/was-fb-mcp status

# Delete saved credentials
npx -y github:was-member-keramat/was-fb-mcp logout

# View CLI usage help
npx -y github:was-member-keramat/was-fb-mcp help

Multi-Account Setup

You can bypass the local config file by passing environment variables in your AI client config:

{
  "mcpServers": {
    "Facebook Account A": {
      "command": "npx",
      "args": ["-y", "github:was-member-keramat/was-fb-mcp"],
      "env": {
        "FB_ACCESS_TOKEN": "EAAX..."
      }
    },
    "Facebook Account B": {
      "command": "npx",
      "args": ["-y", "github:was-member-keramat/was-fb-mcp"],
      "env": {
        "FB_ACCESS_TOKEN": "EAAY..."
      }
    }
  }
}

Troubleshooting

Windows PowerShell Script Execution Error

If you see: File C:\...\npx.ps1 cannot be loaded because running scripts is disabled

Run in PowerShell:

Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned

Force Update / Clear npx Cache on Windows

If npx is serving cached old versions:

Remove-Item -Recurse -Force "$env:LOCALAPPDATA\npm-cache" -ErrorAction SilentlyContinue
npm cache clean --force

Graph API Error Response

If a tool call returns an error, the MCP decodes Meta Graph API's exact error structure (code, error_subcode, fbtrace_id) so the AI assistant can fix permissions or parameters immediately.

License

MIT © 2026 WAS.