Facebook MCP Server

1# Facebook MCP Server
2 
3This 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.
4 
5[![Trust Score](https://archestra.ai/mcp-catalog/api/badge/quality/HagaiHen/facebook-mcp-server)](https://archestra.ai/mcp-catalog/hagaihen__facebook-mcp-server)
6<a href="https://glama.ai/mcp/servers/@HagaiHen/facebook-mcp-server">
7  <img width="380" height="200" src="https://glama.ai/mcp/servers/@HagaiHen/facebook-mcp-server/badge" />
8</a>
9 
10---
11 
12## 🤖 What Is This?
13 
14This MCP provides a suite of AI-callable tools that connect directly to a Facebook Page, abstracting common API operations as LLM-friendly functions.
15 
16### ✅ Benefits
17 
18- Empowers **social media managers** to automate moderation and analytics.
19- Seamlessly integrates with **Claude Desktop or any Agent client**.
20- Enables fine-grained control over Facebook content from natural language.
21 
22---
23 
24## 📦 Features
25 
26| Tool                             | Description                                                         |
27|----------------------------------|---------------------------------------------------------------------|
28| `post_to_facebook`               | Create a new Facebook post with a message.                          |
29| `reply_to_comment`               | Reply to a specific comment on a post.                              |
30| `get_page_posts`                 | Retrieve recent posts from the Page.                                |
31| `get_post_comments`              | Fetch comments on a given post.                                     |
32| `delete_post`                    | Delete a specific post by ID.                                       |
33| `delete_comment`                 | Delete a specific comment by ID.                                    |
34| `hide_comment`                   | Hide a comment from public view.                         |
35| `unhide_comment`                 | Unhide a previously hidden comment.                      |
36| `delete_comment_from_post`       | Alias for deleting a comment from a specific post.                  |
37| `filter_negative_comments`       | Filter out comments with negative sentiment keywords.               |
38| `get_number_of_comments`         | Count the number of comments on a post.                             |
39| `get_number_of_likes`            | Count the number of likes on a post.                                |
40| `get_post_impressions`           | Get total impressions on a post.                                    |
41| `get_post_impressions_unique`    | Get number of unique users who saw the post.                        |
42| `get_post_impressions_paid`      | Get number of paid impressions on the post.                         |
43| `get_post_impressions_organic`   | Get number of organic impressions on the post.                      |
44| `get_post_engaged_users`         | Get number of users who engaged with the post.                      |
45| `get_post_clicks`                | Get number of clicks on the post.                                   |
46| `get_post_reactions_like_total`  | Get total number of 'Like' reactions.                               |
47| `get_post_top_commenters`        | Get the top commenters on a post.                                   |
48| `post_image_to_facebook`         | Post an image with a caption to the Facebook page.                  |
49| `send_dm_to_user`                | Send a direct message to a user.                                    |
50| `update_post`                    | Updates an existing post's message.                                 |
51| `schedule_post`                  | Schedule a post for future publication.                     |
52| `get_page_fan_count`             | Retrieve the total number of Page fans.                     |
53| `get_post_share_count`           | Get the number of shares on a post.                         |
54| `get_post_reactions_breakdown`   | Get all reaction counts for a post in one call.              |
55| `bulk_delete_comments`           | Delete multiple comments by ID.                              |
56| `bulk_hide_comments`             | Hide multiple comments by ID.                    |
57 
58---
59 
60## 🚀 Setup & Installation
61 
62### 1. Clone the Repository
63 
64```bash
65git clone https://github.com/your-org/facebook-mcp-server.git
66cd facebook-mcp-server
67```
68 
69### 2. 🛠️ Installation
70 
71Install dependencies using uv, a fast Python package manager:
72If uv is not already installed, run:
73```bash
74curl -Ls https://astral.sh/uv/install.sh | bash
75```
76 
77Once uv is installed, install the project dependencies:
78```bash
79uv pip install -r requirements.txt
80```
81 
82### 3. Set Up Environment
83 
84Create a .env file in the root directory and add your Facebook Page credentials. 
85You can obtain these from  https://developers.facebook.com/tools/explorer
86 
87```bash
88FACEBOOK_ACCESS_TOKEN=your_facebook_page_access_token
89FACEBOOK_PAGE_ID=your_page_id
90```
91 
92## 🧩 Using with Claude Desktop
93To set up the FacebookMCP in Clade:
94 
951.	Open Clade.
962.	Go to Settings → Developer → Edit Config.
973.	In the config file that opens, add the following entry:
98 
99```bash
100"FacebookMCP": {
101  "command": "uv",
102  "args": [
103    "run",
104    "--with",
105    "mcp[cli]",
106    "--with",
107    "requests",
108    "mcp",
109    "run",
110    "/path/to/facebook-mcp-server/server.py"
111  ]
112}
113```
114 
115---
116 
117## ✅ You’re Ready to Go!
118 
119That’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!
120 
121---
122 
123## 🤝 Contributing
124 
125Contributions, issues, and feature requests are welcome!  
126Feel free to fork the repo and submit a pull request.
127 
128- Create a branch: `git checkout -b feature/YourFeature`
129- Commit your changes: `git commit -m 'feat: add new feature'`
130- Push to the branch: `git push origin feature/YourFeature`
131- Open a pull request 🎉
132