# HagaiHen/facebook-mcp-server [Health: Active] **Category:** 🌐 Social Media **Repository:** https://github.com/HagaiHen/facebook-mcp-server **GitHub Stars:** 220 **Views:** 2 **Installs:** 0 **Upvotes:** 0 **Directory Page:** https://allmcps.com/mcp/hagaihen-facebook-mcp-server ## Description Integrates with Facebook Pages to enable direct management of posts, comments, and engagement metrics through the Graph API for streamlined social media management. ## Claude Desktop Quick Installation Heuristic fallback β€” verify the package name and runner against the repository README before running it. Uses `npx` (confidence: low): ```json "mcpServers": { "facebook-mcp-server": { "command": "npx", "args": ["-y","hagaihen-facebook-mcp-server"], "env": { "FACEBOOK_ACCESS_TOKEN": "", "FACEBOOK_PAGE_ID": "" } } } ``` **Requires environment variables:** `FACEBOOK_ACCESS_TOKEN`, `FACEBOOK_PAGE_ID` β€” the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for). ## Documentation & README # Facebook MCP Server This project is a **MCP server** for automating and managing interactions on a Facebook Page using the Facebook Graph API. It exposes tools to create posts, moderate comments, fetch post insights, and filter negative feedback β€” ready to plug into Claude, or other LLM-based agents. [![Trust Score](https://archestra.ai/mcp-catalog/api/badge/quality/HagaiHen/facebook-mcp-server)](https://archestra.ai/mcp-catalog/hagaihen__facebook-mcp-server) --- ## πŸ€– What Is This? This MCP provides a suite of AI-callable tools that connect directly to a Facebook Page, abstracting common API operations as LLM-friendly functions. ### βœ… Benefits - Empowers **social media managers** to automate moderation and analytics. - Seamlessly integrates with **Claude Desktop or any Agent client**. - Enables fine-grained control over Facebook content from natural language. --- ## πŸ“¦ Features | Tool | Description | |----------------------------------|---------------------------------------------------------------------| | `post_to_facebook` | Create a new Facebook post with a message. | | `reply_to_comment` | Reply to a specific comment on a post. | | `get_page_posts` | Retrieve recent posts from the Page. | | `get_post_comments` | Fetch comments on a given post. | | `delete_post` | Delete a specific post by ID. | | `delete_comment` | Delete a specific comment by ID. | | `hide_comment` | Hide a comment from public view. | | `unhide_comment` | Unhide a previously hidden comment. | | `delete_comment_from_post` | Alias for deleting a comment from a specific post. | | `filter_negative_comments` | Filter out comments with negative sentiment keywords. | | `get_number_of_comments` | Count the number of comments on a post. | | `get_number_of_likes` | Count the number of likes on a post. | | `get_post_impressions` | Get total impressions on a post. | | `get_post_impressions_unique` | Get number of unique users who saw the post. | | `get_post_impressions_paid` | Get number of paid impressions on the post. | | `get_post_impressions_organic` | Get number of organic impressions on the post. | | `get_post_engaged_users` | Get number of users who engaged with the post. | | `get_post_clicks` | Get number of clicks on the post. | | `get_post_reactions_like_total` | Get total number of 'Like' reactions. | | `get_post_top_commenters` | Get the top commenters on a post. | | `post_image_to_facebook` | Post an image with a caption to the Facebook page. | | `send_dm_to_user` | Send a direct message to a user. | | `update_post` | Updates an existing post's message. | | `schedule_post` | Schedule a post for future publication. | | `get_page_fan_count` | Retrieve the total number of Page fans. | | `get_post_share_count` | Get the number of shares on a post. | | `get_post_reactions_breakdown` | Get all reaction counts for a post in one call. | | `bulk_delete_comments` | Delete multiple comments by ID. | | `bulk_hide_comments` | Hide multiple comments by ID. | | `bulk_unhide_comments` | Unhide multiple comments by ID. | | `get_comment_replies` | Get all replies to a specific comment. | | `get_post_permalink` | Get the permalink URL of a post. | | `get_scheduled_posts` | List all scheduled (unpublished) posts on the Page. | | `get_page_info` | Get extended Page details (name, about, category, website). | --- ## πŸš€ Setup & Installation ### 1. Clone the Repository ```bash git clone https://github.com/your-org/facebook-mcp-server.git cd facebook-mcp-server ``` ### 2. πŸ› οΈ Installation Install dependencies using uv, a fast Python package manager: If uv is not already installed, run: ```bash curl -Ls https://astral.sh/uv/install.sh | bash ``` Once uv is installed, install the project dependencies: ```bash uv pip install -r requirements.txt ``` ### 3. Set Up Environment Create a .env file in the root directory and add your Facebook Page credentials. You can obtain these from https://developers.facebook.com/tools/explorer ```bash FACEBOOK_ACCESS_TOKEN=your_facebook_page_access_token FACEBOOK_PAGE_ID=your_page_id ``` ## 🧩 Using with Claude Desktop To set up the FacebookMCP in Clade: 1. Open Clade. 2. Go to Settings β†’ Developer β†’ Edit Config. 3. In the config file that opens, add the following entry: ```bash "FacebookMCP": { "command": "uv", "args": [ "run", "--with", "mcp[cli]", "--with", "requests", "mcp", "run", "/path/to/facebook-mcp-server/server.py" ] } ``` --- ## βœ… You’re Ready to Go! That’s it β€” your Facebook MCP server is now fully configured and ready to power Claude Desktop. You can now post, moderate, and measure engagement all through natural language prompts! --- ## 🀝 Contributing Contributions, issues, and feature requests are welcome! Feel free to fork the repo and submit a pull request. - Create a branch: `git checkout -b feature/YourFeature` - Commit your changes: `git commit -m 'feat: add new feature'` - Push to the branch: `git push origin feature/YourFeature` - Open a pull request πŸŽ‰