<div align="center"> <img src="https://raw.githubusercontent.com/promobase/facebook-business-mcp/refs/heads/dev/assets/OpenPromo.svg" alt="OpenPromo Logo" width="340" height="50" /> </div>

---

<div align="center">****

</div>

Facebook Business MCP Server

Unofficial MCP server implementation for Facebook Business API. You can use this with any clients/LLMs to manage your ad campaigns, ads, etc.

Features

• Complete: implementation is wrapped on top of api specs & python sdk, for full typesafty.
• MCP Compliant: Built with FastMCP for seamless integration with any MCP-compatible client or LLM.
• Easy Setup: Simple configuration with environment variables and immediate connectivity to Facebook Business API.

Installation

Quick Start

You can run the server directly without installation using uvx:

uvx facebook-business-mcp

Local Installation

pip install facebook-business-mcp

Setup

1. Set environment variables:

   export FACEBOOK_APP_ID="your-app-id"
   export FACEBOOK_APP_SECRET="your-app-secret"
   export FACEBOOK_ACCESS_TOKEN="your-access-token"
   export FACEBOOK_AD_ACCOUNT_ID="your-ad-account-id"  # optional
   

2. Run the server:

   Using uvx (no installation needed):

   uvx facebook-business-mcp
   

   Or if installed via pip:

   facebook-business-mcp
   

   Or from source:

   uv run main.py
   

License

MIT