Facebook MCP Server

Facebook MCP Server

A simple Model Context Protocol (MCP) server for connecting to Facebook business pages and posting text messages.

Features

• Connect Facebook Page: Connect your Facebook business page using an access token
• Post to Facebook: Post simple text messages to your connected Facebook page
• Check Connection: Verify your Facebook page connection status
• User Data Storage: Automatically saves user connection data to JSON file

Setup

1. Install dependencies:

2. Configure Facebook App:
   • Copy env.example to .env
   • Fill in your Facebook App ID and App Secret
   • Set the redirect URI to http://localhost:3000/auth/facebook/callback
3. Build the project:

4. Run the server:

Usage

Method 1: OAuth Flow (Recommended for Mistral Le Chat)

1. Get Login URL: Use the get_facebook_login_url tool with your userId
2. Click the URL: Open the provided URL in your browser
3. Authorize: Complete Facebook authorization in the browser
4. Return to Chat: Come back to Mistral Le Chat and use other tools

Method 2: Manual Connection

Use the connect_facebook_page tool with:

• userId: A unique identifier for the user
• accessToken: Your Facebook page access token
• pageId: Your Facebook page ID
• pageName: Your Facebook page name

3. Post to Facebook

Use the post_to_facebook tool with:

• userId: The same user ID used during connection
• message: The text message you want to post

4. Check Connection

Use the check_facebook_connection tool with:

• userId: The user ID to check connection for

Getting Facebook App Credentials

1. Go to Facebook Developers
2. Create a new app or use an existing one
3. Add the "Facebook Login" product
4. In App Settings, note down:
   • App ID: Your Facebook App ID
   • App Secret: Your Facebook App Secret
5. Add these to your .env file
6. Set the redirect URI to: http://localhost:3000/auth/facebook/callback

User Data Storage

User connection data is automatically saved to user_data.json in the project root. This includes:

• User ID
• Facebook access token
• Page ID and name
• Connection timestamp

Tools Available

1. get_facebook_login_url: Get OAuth login URL (recommended for Mistral Le Chat)
2. connect_facebook_page: Manually connect a Facebook business page
3. post_to_facebook: Post a text message to Facebook
4. check_facebook_connection: Check connection status

Example Usage

OAuth Flow (Recommended)

Manual Connection