TypeScript MCP server for the Meta Graph API — operate your Facebook Page (publish, read & analyze insights, moderate comments & messages) from an AI assistant. Local-first, least-privilege, with plan-and-apply write safety.
Setup
Choose your client, copy the config, then fill in any required environment variables.
claude mcp add facebook --env FB_SYSTEM_TOKEN='<FB_SYSTEM_TOKEN>' --env FB_ACCESS_TOKEN='<FB_ACCESS_TOKEN>' --env FB_PAGE_TOKEN='<FB_PAGE_TOKEN>' --env FB_APP_SECRET='<FB_APP_SECRET>' --env FB_CONFIRM_TOKEN='<FB_CONFIRM_TOKEN>' --env FB_HTTP_TOKEN='<FB_HTTP_TOKEN>' -- npx -y @ivanbaev/facebook-mcp~/.codex/config.toml
[mcp_servers.facebook]
command = "npx"
args = ["-y", "@ivanbaev/facebook-mcp"]
env = { FB_SYSTEM_TOKEN = "<FB_SYSTEM_TOKEN>", FB_ACCESS_TOKEN = "<FB_ACCESS_TOKEN>", FB_PAGE_TOKEN = "<FB_PAGE_TOKEN>", FB_APP_SECRET = "<FB_APP_SECRET>", FB_CONFIRM_TOKEN = "<FB_CONFIRM_TOKEN>", FB_HTTP_TOKEN = "<FB_HTTP_TOKEN>" }
# codex mcp add facebook --env FB_SYSTEM_TOKEN='<FB_SYSTEM_TOKEN>' --env FB_ACCESS_TOKEN='<FB_ACCESS_TOKEN>' --env FB_PAGE_TOKEN='<FB_PAGE_TOKEN>' --env FB_APP_SECRET='<FB_APP_SECRET>' --env FB_CONFIRM_TOKEN='<FB_CONFIRM_TOKEN>' --env FB_HTTP_TOKEN='<FB_HTTP_TOKEN>' -- npx -y @ivanbaev/facebook-mcp~/.cursor/mcp.json
{
"mcpServers": {
"facebook": {
"command": "npx",
"args": [
"-y",
"@ivanbaev/facebook-mcp"
],
"env": {
"FB_SYSTEM_TOKEN": "<FB_SYSTEM_TOKEN>",
"FB_ACCESS_TOKEN": "<FB_ACCESS_TOKEN>",
"FB_PAGE_TOKEN": "<FB_PAGE_TOKEN>",
"FB_APP_SECRET": "<FB_APP_SECRET>",
"FB_CONFIRM_TOKEN": "<FB_CONFIRM_TOKEN>",
"FB_HTTP_TOKEN": "<FB_HTTP_TOKEN>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"facebook": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@ivanbaev/facebook-mcp"
],
"env": {
"FB_SYSTEM_TOKEN": "<FB_SYSTEM_TOKEN>",
"FB_ACCESS_TOKEN": "<FB_ACCESS_TOKEN>",
"FB_PAGE_TOKEN": "<FB_PAGE_TOKEN>",
"FB_APP_SECRET": "<FB_APP_SECRET>",
"FB_CONFIRM_TOKEN": "<FB_CONFIRM_TOKEN>",
"FB_HTTP_TOKEN": "<FB_HTTP_TOKEN>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"facebook": {
"command": "npx",
"args": [
"-y",
"@ivanbaev/facebook-mcp"
],
"env": {
"FB_SYSTEM_TOKEN": "<FB_SYSTEM_TOKEN>",
"FB_ACCESS_TOKEN": "<FB_ACCESS_TOKEN>",
"FB_PAGE_TOKEN": "<FB_PAGE_TOKEN>",
"FB_APP_SECRET": "<FB_APP_SECRET>",
"FB_CONFIRM_TOKEN": "<FB_CONFIRM_TOKEN>",
"FB_HTTP_TOKEN": "<FB_HTTP_TOKEN>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"facebook": {
"command": "npx",
"args": [
"-y",
"@ivanbaev/facebook-mcp"
],
"env": {
"FB_SYSTEM_TOKEN": "<FB_SYSTEM_TOKEN>",
"FB_ACCESS_TOKEN": "<FB_ACCESS_TOKEN>",
"FB_PAGE_TOKEN": "<FB_PAGE_TOKEN>",
"FB_APP_SECRET": "<FB_APP_SECRET>",
"FB_CONFIRM_TOKEN": "<FB_CONFIRM_TOKEN>",
"FB_HTTP_TOKEN": "<FB_HTTP_TOKEN>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"facebook": {
"command": "npx",
"args": [
"-y",
"@ivanbaev/facebook-mcp"
],
"env": {
"FB_SYSTEM_TOKEN": "<FB_SYSTEM_TOKEN>",
"FB_ACCESS_TOKEN": "<FB_ACCESS_TOKEN>",
"FB_PAGE_TOKEN": "<FB_PAGE_TOKEN>",
"FB_APP_SECRET": "<FB_APP_SECRET>",
"FB_CONFIRM_TOKEN": "<FB_CONFIRM_TOKEN>",
"FB_HTTP_TOKEN": "<FB_HTTP_TOKEN>"
}
}
}
}Environment variables
FB_SYSTEM_TOKENFB_ACCESS_TOKENFB_PAGE_TOKENFB_APP_SECRETFB_CONFIRM_TOKENFB_HTTP_TOKEN
Replace the placeholders with your own credentials and keep them out of version control.