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:

npm install

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:

npm run build

4. Run the server:

# For stdio mode
npm start

# For HTTP mode
npm run start:http

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)

// Step 1: Get login URL
get_facebook_login_url({
  userId: "user123"
});

// Step 2: Click the URL in browser, complete Facebook auth
// Step 3: Use other tools
post_to_facebook({
  userId: "user123",
  message: "Hello from MCP server!"
});

Manual Connection

// Connect to Facebook page manually
connect_facebook_page({
  userId: "user123",
  accessToken: "your_page_access_token",
  pageId: "your_page_id",
  pageName: "Your Page Name"
});

// Post a message
post_to_facebook({
  userId: "user123",
  message: "Hello from MCP server!"
});

// Check connection
check_facebook_connection({
  userId: "user123"
});