# Facebook MCP

> Facebook MCP is an open-source MCP server for marketing and seo. Facebook Pages MCP over the Meta Graph API: publish, insights, moderation, Messenger. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** self-hosted, CLI, API
- **Website:** https://ivanbbaev.github.io/facebook-mcp/
- **Repository:** https://github.com/ivanbbaev/facebook-mcp
- **MCP Registry name:** io.github.IvanBBaev/facebook-mcp
- **Categories:** marketing and SEO, communication
- **Listing updated:** 2026-11-14

## About

This is a pre-1.0 project, and its maintainer says so plainly: all 69 tools are implemented and tested against fakes and recorded fixtures behind a network fence, but nothing has been verified against a live Page or Graph API yet. It targets developers who run their own Pages and are willing to create a Meta developer app.

Tools are grouped into eight packages, with `core` always on. You can enable or deny whole packages, or keep only reads with a read-only switch. Writes default to plan mode, returning a validated preview first; irreversible and spend actions always need a per-call apply plus a plan id, and an optional confirmation token adds out-of-band approval. Credentials can be a system-user, user or Page token, and an app secret adds appsecret_proof to every call. A `doctor` command inspects a token's type, expiry and scopes, and `setup-token` writes a private env file.

It runs locally with your own token, sends no telemetry and is limited to three network hosts. It does not cover personal profiles, Groups or Instagram, though a sibling server handles Instagram.

## Features

- **Eight tool packages:** Enable, deny or make read-only whole groups of tools.
- **Plan and apply writes:** Writes return a preview by default; risky ones need a plan id.
- **Token doctor:** Reports token type, expiry, scopes and which packages are usable.
- **Publishing and insights:** Publishes, schedules, reads Page insights and posts.
- **Moderation and Messenger:** Handles comments and replies to Messenger threads.
- **Ads tools:** Targets the Marketing API with its own pinned version.

## Good for

- Draft and schedule a Page post with a preview
- Triage unanswered comments on recent posts
- Produce a weekly Page report
- Answer Messenger threads from an assistant

## Install

### Claude Code (Terminal)

```sh
claude mcp add facebook-mcp --env FB_SYSTEM_TOKEN='<FB_SYSTEM_TOKEN>' --env FB_ACCESS_TOKEN='<FB_ACCESS_TOKEN>' --env FB_PAGE_TOKEN='<FB_PAGE_TOKEN>' --env FB_APP_SECRET='<FB_APP_SECRET>' --env FB_CONFIRM_TOKEN='<FB_CONFIRM_TOKEN>' --env FB_HTTP_TOKEN='<FB_HTTP_TOKEN>' -- npx -y @ivanbaev/facebook-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "facebook-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@ivanbaev/facebook-mcp"
      ],
      "env": {
        "FB_SYSTEM_TOKEN": "<FB_SYSTEM_TOKEN>",
        "FB_ACCESS_TOKEN": "<FB_ACCESS_TOKEN>",
        "FB_PAGE_TOKEN": "<FB_PAGE_TOKEN>",
        "FB_APP_SECRET": "<FB_APP_SECRET>",
        "FB_CONFIRM_TOKEN": "<FB_CONFIRM_TOKEN>",
        "FB_HTTP_TOKEN": "<FB_HTTP_TOKEN>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "facebook-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@ivanbaev/facebook-mcp"
      ],
      "env": {
        "FB_SYSTEM_TOKEN": "<FB_SYSTEM_TOKEN>",
        "FB_ACCESS_TOKEN": "<FB_ACCESS_TOKEN>",
        "FB_PAGE_TOKEN": "<FB_PAGE_TOKEN>",
        "FB_APP_SECRET": "<FB_APP_SECRET>",
        "FB_CONFIRM_TOKEN": "<FB_CONFIRM_TOKEN>",
        "FB_HTTP_TOKEN": "<FB_HTTP_TOKEN>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "facebook-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@ivanbaev/facebook-mcp"
      ],
      "env": {
        "FB_SYSTEM_TOKEN": "<FB_SYSTEM_TOKEN>",
        "FB_ACCESS_TOKEN": "<FB_ACCESS_TOKEN>",
        "FB_PAGE_TOKEN": "<FB_PAGE_TOKEN>",
        "FB_APP_SECRET": "<FB_APP_SECRET>",
        "FB_CONFIRM_TOKEN": "<FB_CONFIRM_TOKEN>",
        "FB_HTTP_TOKEN": "<FB_HTTP_TOKEN>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "facebook-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@ivanbaev/facebook-mcp"
      ],
      "env": {
        "FB_SYSTEM_TOKEN": "<FB_SYSTEM_TOKEN>",
        "FB_ACCESS_TOKEN": "<FB_ACCESS_TOKEN>",
        "FB_PAGE_TOKEN": "<FB_PAGE_TOKEN>",
        "FB_APP_SECRET": "<FB_APP_SECRET>",
        "FB_CONFIRM_TOKEN": "<FB_CONFIRM_TOKEN>",
        "FB_HTTP_TOKEN": "<FB_HTTP_TOKEN>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "facebook-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@ivanbaev/facebook-mcp"
      ],
      "env": {
        "FB_SYSTEM_TOKEN": "<FB_SYSTEM_TOKEN>",
        "FB_ACCESS_TOKEN": "<FB_ACCESS_TOKEN>",
        "FB_PAGE_TOKEN": "<FB_PAGE_TOKEN>",
        "FB_APP_SECRET": "<FB_APP_SECRET>",
        "FB_CONFIRM_TOKEN": "<FB_CONFIRM_TOKEN>",
        "FB_HTTP_TOKEN": "<FB_HTTP_TOKEN>"
      }
    }
  }
}
```

## Tools

- `facebook_whoami`: Report the acting identity and Page for the configured credential

## FAQ

### Is it production-ready?

Not yet. The project calls itself pre-1.0 and not verified against a live Page.

### What licence and runtime?

MIT, TypeScript, Node 22 or newer.

### Can I make it read-only?

Yes. An environment setting drops every write tool while keeping reads.

### Does it support personal profiles or Groups?

No; the README lists profiles, Groups and Instagram as out of scope.

### Is Facebook MCP free?

Yes. Facebook MCP is open source, so you can use and self-host it for free.

### How do I add Facebook MCP to Claude Code?

Run this command in your terminal: claude mcp add facebook-mcp --env FB_SYSTEM_TOKEN='<FB_SYSTEM_TOKEN>' --env FB_ACCESS_TOKEN='<FB_ACCESS_TOKEN>' --env FB_PAGE_TOKEN='<FB_PAGE_TOKEN>' --env FB_APP_SECRET='<FB_APP_SECRET>' --env FB_CONFIRM_TOKEN='<FB_CONFIRM_TOKEN>' --env FB_HTTP_TOKEN='<FB_HTTP_TOKEN>' -- npx -y @ivanbaev/facebook-mcp

### What are the best alternatives to Facebook MCP?

The closest alternatives to Facebook MCP are Google Ads + Meta Ads + SEO/GEO MCP, Calven, MCP, BoardAgent and Callout.

## Alternatives

- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Calven](https://ai-powered.com/mcp/calven): Calven is an MCP server for marketing and seo.
- [MCP](https://ai-powered.com/mcp/mcp-mwhffe53): MCP is a freemium MCP server for marketing and seo.
- [BoardAgent](https://ai-powered.com/mcp/boardagent): BoardAgent is a free MCP server for community directories.
- [Callout](https://ai-powered.com/mcp/callout): Callout is a freemium MCP server for communication.
- [Red Center Studio free tools](https://ai-powered.com/mcp/red-center-studio-free-tools): Red Center Studio free tools is a free MCP server for marketing and seo.
- [nicemails](https://ai-powered.com/mcp/nicemails): nicemails is a freemium MCP server for communication.
- [SOMMON Office](https://ai-powered.com/mcp/sommon-office): SOMMON Office is a paid MCP server for communication.

---
Source: https://ai-powered.com/mcp/facebook-mcp
