Tisik79/MCP-Facebook
If you are the rightful owner of MCP-Facebook and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.
The Facebook Ads MCP Server is designed to interact with the Facebook Marketing API, enabling AI assistants to manage and analyze Facebook ad campaigns.
Facebook Ads MCP Server
This project provides a Model Context Protocol (MCP) server designed to interact with the Facebook Marketing API, allowing AI assistants like Claude to manage and analyze Facebook ad campaigns, ad sets, audiences, and more.
Features
- Campaign Management: Create, read, update, delete campaigns.
- Audience Management: Create custom and lookalike audiences, list audiences.
- Ad Set Management: Create ad sets (basic implementation).
- Post Management: Create organic posts on Facebook Pages.
- Analytics: Get campaign insights.
- AI Assistance: Generate prompts for campaign creation based on templates.
Prerequisites
- Node.js (v18 or later recommended)
- npm (comes with Node.js)
- A Facebook App with access to the Marketing API
- A Facebook Ad Account ID
- An Access Token with
ads_managementandads_readpermissions
Installation
-
Clone the repository:
git clone https://github.com/Tisik79/MCP-Facebook.git cd MCP-Facebook -
Install dependencies:
npm install -
Configure Environment Variables: Copy the
.env.examplefile to.envin the project root and add your Facebook App credentials:cp .env.example .envThen edit the
.envfile with your actual values:FACEBOOK_APP_ID=YOUR_APP_ID FACEBOOK_APP_SECRET=YOUR_APP_SECRET FACEBOOK_ACCESS_TOKEN=YOUR_ACCESS_TOKEN FACEBOOK_ACCOUNT_ID=act_YOUR_ACCOUNT_ID PORT=3000Replace placeholders with your actual values. Ensure the Access Token has the
ads_managementandpages_manage_postspermissions.Security Note: Never commit your
.envfile to version control. The.envfile is already included in.gitignore.
Usage
-
Build the server:
npm run buildThis compiles the TypeScript code to JavaScript in the
distfolder. -
Run the server:
npm startThe server will start and listen for MCP connections via stdio.
-
Connect with an MCP Client (e.g., Claude Desktop): Follow the instructions in
CLAUDE_DESKTOP_GUIDE.mdto configure your MCP client to connect to this server using thenpm startcommand or by directly runningnode dist/index.js.
Available Tools (via MCP)
Campaign Management
create_campaign: Creates a new ad campaign.get_campaigns: Lists existing campaigns.get_campaign_details: Gets details for a specific campaign.update_campaign: Updates an existing campaign.delete_campaign: Deletes a campaign.
Ad Set Management
create_ad_set: Creates a new ad set.get_adsets: Lists ad sets with optional filtering by campaign, status, and limit.
Ad Management
get_ads: Lists ads with optional filtering by ad set, campaign, status, and limit.
Audience Management
create_custom_audience: Creates a custom, website, or engagement audience.get_audiences: Lists available custom audiences.create_lookalike_audience: Creates a lookalike audience.
Post Management
create_post: Creates an organic post on a Facebook Page. Supports text posts, posts with links, and posts with images.
Analytics
get_campaign_insights: Retrieves performance insights for a campaign.get_adset_insights: Retrieves performance insights for an ad set.get_ad_insights: Retrieves performance insights for an individual ad.
Refer to the server's tool descriptions in your MCP client for detailed parameter information.
Contributing
Contributions are welcome! Please feel free to submit pull requests or open issues.
License
This project is licensed under the MIT License.
