facebook-business-mcp 0.0.9.dev2

unofficial MCP server implementation for Facebook Business API

---

****

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