What is the Facebook MCP server & CLI?

The Facebook MCP server & CLI is a free, open source program that lets an AI app like Claude , Codex or Cursor work with your Facebook Pages. It has 15 tools for posts, drafts, scheduling, comments and insights on your Facebook Pages, and the same tools run as a CLI that agents like Claude Code and Codex use, or that you type yourself.

What is an MCP server?

An MCP server is a standard way to give an AI app real access to a tool, so it can act instead of guessing. MCP stands for Model Context Protocol, and Claude, Codex, Cursor and many other AI apps speak it. Every server I've made is on my MCP servers page.

What is the Facebook CLI?

The Facebook CLI is the same program as the Facebook MCP server, run as commands. AI agents like Claude Code , Codex and OpenCode run them for you, and you can type them in a terminal or a script. One npm package installs both.

Should I use the Facebook MCP server or the CLI?

Use the Facebook MCP server in an AI app with no terminal, like Claude Desktop's chat, and the CLI in a terminal, a script or a cron job. In an AI app that can run commands, like Claude Code, Codex or Cursor, the CLI is the lighter choice, because it costs nothing until it runs.

Is the Facebook MCP server free?

Yes, the Facebook MCP server is free and open source under the MIT license. Meta's Graph API costs nothing for your own Pages, so the only thing you pay for is your own AI app.

Do I need App Review or Business Verification?

No, you don't need either for your own Pages. Standard Access covers Pages where you have a role on the app, and Meta grants it as soon as you add the permissions.

Can it post to my personal profile?

No, Meta removed profile posting from its API in 2018. The server works with Pages only.

Why did my tokens stop working the next day?

Tokens made without your app's ID and secret expire with the short-lived token they came from. Set FACEBOOK_APP_ID and FACEBOOK_APP_SECRET before you run login, and the Page tokens it saves never expire.

Can it schedule posts?

Yes, once you turn writing on. It saves drafts, schedules posts from 10 minutes to 6 months ahead, and lists everything that hasn't gone out yet.

Can I connect more than one Facebook Page?

Yes, login saves every Page you run, and every tool takes a page argument. FACEBOOK_PREFERRED_PAGES sets which Page is the default.

Which AI apps does the Facebook MCP server work with?

The Facebook MCP server works with any app that speaks MCP. That includes Claude Code, Claude Desktop, Codex, Cursor, VS Code, Windsurf, Zed, Cline, GitHub Copilot CLI, Gemini CLI, OpenCode, OpenClaw, Antigravity and Hermes.

Who made the Facebook MCP server & CLI?

I did. I'm Navid Moazzez, and I made the Facebook MCP server & CLI as one of my free tools on navid.me. You can read more about me . The code is on GitHub under the MIT license, and the package is on npm .

Facebook MCP Server & CLI

Name: Facebook MCP server & CLI
Author: Navid Moazzez

A free, open source Facebook MCP server and CLI that lets Claude Code, Codex, Cursor and other AI agents read your Page insights, schedule posts and moderate comments.

Star on GitHub

npm

door Navid Moazzez·Bijgewerkt 5 okt 2026·13 min leestijd·

MCP CLI

Your computer

macOS Windows Linux

Add it with a single command in a terminal.

claude mcp add facebook \
  -- npx -y @thenavidm/facebook-mcp-cli@latest

2
In Claude Code, type /mcp. Facebook should show as connected.
```
/mcp
```

Your computer

macOS Windows Linux

Add it with a single command in a terminal.

codex mcp add facebook \
  -- npx -y @thenavidm/facebook-mcp-cli@latest

2
Check that Codex lists it.
```
codex mcp list
```

1
Open Cursor's settings, go to the MCP tab, and click Add new global MCP server.

Add the server.

{
  "mcpServers": {
    "facebook": {
      "command": "npx",
      "args": ["-y", "@thenavidm/facebook-mcp-cli@latest"]
    }
  }
}

3
Open the MCP tab again. It should show 15 tools.

1
Open the Command Palette and run MCP: Open User Configuration.

Add the server to that mcp.json.

If the file already has servers, add only this one inside servers.

{
  "servers": {
    "facebook": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@thenavidm/facebook-mcp-cli@latest"]
    }
  }
}

Your computer

macOS Windows Linux

Add it with a single command in a terminal.

copilot mcp add facebook \
  -- npx -y @thenavidm/facebook-mcp-cli@latest

2
Check that Copilot CLI has it.
```
copilot mcp get facebook
```

Your computer

macOS Windows Linux

1
Open your Gemini CLI settings.
```
~/.gemini/settings.json
```

Add the server to settings.json.

If the file already has servers, add only this one inside mcpServers.

{
  "mcpServers": {
    "facebook": {
      "command": "npx",
      "args": ["-y", "@thenavidm/facebook-mcp-cli@latest"]
    }
  }
}

3
Restart Gemini CLI and type /mcp to check it.
```
/mcp
```

1
Open your Gemini CLI settings.
```
%USERPROFILE%\.gemini\settings.json
```

Add the server to settings.json.

If the file already has servers, add only this one inside mcpServers.

{
  "mcpServers": {
    "facebook": {
      "command": "npx",
      "args": ["-y", "@thenavidm/facebook-mcp-cli@latest"]
    }
  }
}

3
Restart Gemini CLI and type /mcp to check it.
```
/mcp
```

1
Open your Gemini CLI settings.
```
~/.gemini/settings.json
```

Add the server to settings.json.

If the file already has servers, add only this one inside mcpServers.

{
  "mcpServers": {
    "facebook": {
      "command": "npx",
      "args": ["-y", "@thenavidm/facebook-mcp-cli@latest"]
    }
  }
}

3
Restart Gemini CLI and type /mcp to check it.
```
/mcp
```

Your computer

macOS Windows Linux

1
Open your OpenCode config.
```
~/.config/opencode/opencode.json
```

Add the server under mcp.

If the file already has servers, add only this one inside mcp.

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "facebook": {
      "type": "local",
      "command": ["npx", "-y", "@thenavidm/facebook-mcp-cli@latest"],
      "enabled": true
    }
  }
}

3
Restart OpenCode.

Open your OpenCode config.

%USERPROFILE%\.config\opencode\opencode.json

Add the server under mcp.

If the file already has servers, add only this one inside mcp.

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "facebook": {
      "type": "local",
      "command": ["npx", "-y", "@thenavidm/facebook-mcp-cli@latest"],
      "enabled": true
    }
  }
}

3
Restart OpenCode.

1
Open your OpenCode config.
```
~/.config/opencode/opencode.json
```

Add the server under mcp.

If the file already has servers, add only this one inside mcp.

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "facebook": {
      "type": "local",
      "command": ["npx", "-y", "@thenavidm/facebook-mcp-cli@latest"],
      "enabled": true
    }
  }
}

3
Restart OpenCode.

Your computer

macOS Windows Linux

Add it with a single command in a terminal.

openclaw mcp add facebook \
  --command npx \
  --arg -y \
  --arg @thenavidm/facebook-mcp-cli@latest

2
Check that it starts and lists its tools.
```
openclaw mcp doctor facebook --probe
```

Add it with a single command in a terminal.

openclaw mcp add facebook --command npx --arg -y --arg @thenavidm/facebook-mcp-cli@latest

2
Check that it starts and lists its tools.
```
openclaw mcp doctor facebook --probe
```

Add it with a single command in a terminal.

openclaw mcp add facebook \
  --command npx \
  --arg -y \
  --arg @thenavidm/facebook-mcp-cli@latest

2
Check that it starts and lists its tools.
```
openclaw mcp doctor facebook --probe
```

1
In the agent panel, click the … menu, then MCP Servers, Manage MCP Servers and View raw config.

Add the server to mcp_config.json.

If the file already has servers, add only this one inside mcpServers.

{
  "mcpServers": {
    "facebook": {
      "command": "npx",
      "args": ["-y", "@thenavidm/facebook-mcp-cli@latest"]
    }
  }
}

Your computer

macOS Windows Linux

1
Open your Hermes config.
```
~/.hermes/config.yaml
```

Add the server under mcp_servers.

If the file already has mcp_servers, add only this one under it.

mcp_servers:
  facebook:
    command: "npx"
    args: ["-y", "@thenavidm/facebook-mcp-cli@latest"]

1
Open your Hermes config.
```
%USERPROFILE%\.hermes\config.yaml
```

Add the server under mcp_servers.

If the file already has mcp_servers, add only this one under it.

mcp_servers:
  facebook:
    command: "npx"
    args: ["-y", "@thenavidm/facebook-mcp-cli@latest"]

1
Open your Hermes config.
```
~/.hermes/config.yaml
```

Add the server under mcp_servers.

If the file already has mcp_servers, add only this one under it.

mcp_servers:
  facebook:
    command: "npx"
    args: ["-y", "@thenavidm/facebook-mcp-cli@latest"]

Your computer

macOS Windows Linux

Install the CLI. It needs Node 22 or newer.

npm install -g @thenavidm/facebook-mcp-cli@latest

2
Give Claude Code the skill, so it knows every command.
The skill is the SKILL.md in the package. It tells Claude Code what each command does and which ones ask first.
```
mkdir -p ~/.claude/skills/facebook-mcp
cp "$(npm root -g)/@thenavidm/facebook-mcp-cli/SKILL.md" ~/.claude/skills/facebook-mcp/
```
3
Check your setup.
It names anything that's wrong and the fix.
```
facebook-cli doctor
```
4
Ask Claude Code to use facebook-cli.
Running facebook-cli on its own lists every command, so Claude Code finds the one it needs.

Install the CLI. It needs Node 22 or newer.

npm install -g @thenavidm/facebook-mcp-cli@latest

Give Claude Code the skill, so it knows every command.

The skill is the SKILL.md in the package. It tells Claude Code what each command does and which ones ask first.

New-Item -ItemType Directory -Force "$HOME\.claude\skills\facebook-mcp" | Out-Null
Copy-Item "$(npm root -g)\@thenavidm\facebook-mcp-cli\SKILL.md" "$HOME\.claude\skills\facebook-mcp\"

3
Check your setup.
It names anything that's wrong and the fix.
```
facebook-cli doctor
```
4
Ask Claude Code to use facebook-cli.
Running facebook-cli on its own lists every command, so Claude Code finds the one it needs.

Install the CLI. It needs Node 22 or newer.

npm install -g @thenavidm/facebook-mcp-cli@latest

2
Give Claude Code the skill, so it knows every command.
The skill is the SKILL.md in the package. It tells Claude Code what each command does and which ones ask first.
```
mkdir -p ~/.claude/skills/facebook-mcp
cp "$(npm root -g)/@thenavidm/facebook-mcp-cli/SKILL.md" ~/.claude/skills/facebook-mcp/
```
3
Check your setup.
It names anything that's wrong and the fix.
```
facebook-cli doctor
```
4
Ask Claude Code to use facebook-cli.
Running facebook-cli on its own lists every command, so Claude Code finds the one it needs.

Your computer

macOS Windows Linux

Install the CLI. It needs Node 22 or newer.

npm install -g @thenavidm/facebook-mcp-cli@latest

2
Give Codex the skill, so it knows every command.
The skill is the SKILL.md in the package. It tells Codex what each command does and which ones ask first.
```
mkdir -p ~/.agents/skills/facebook-mcp
cp "$(npm root -g)/@thenavidm/facebook-mcp-cli/SKILL.md" ~/.agents/skills/facebook-mcp/
```
3
Check your setup.
It names anything that's wrong and the fix.
```
facebook-cli doctor
```
4
Ask Codex to use facebook-cli.
Running facebook-cli on its own lists every command, so Codex finds the one it needs.

Install the CLI. It needs Node 22 or newer.

npm install -g @thenavidm/facebook-mcp-cli@latest

Give Codex the skill, so it knows every command.

The skill is the SKILL.md in the package. It tells Codex what each command does and which ones ask first.

New-Item -ItemType Directory -Force "$HOME\.agents\skills\facebook-mcp" | Out-Null
Copy-Item "$(npm root -g)\@thenavidm\facebook-mcp-cli\SKILL.md" "$HOME\.agents\skills\facebook-mcp\"

3
Check your setup.
It names anything that's wrong and the fix.
```
facebook-cli doctor
```
4
Ask Codex to use facebook-cli.
Running facebook-cli on its own lists every command, so Codex finds the one it needs.

Install the CLI. It needs Node 22 or newer.

npm install -g @thenavidm/facebook-mcp-cli@latest

2
Give Codex the skill, so it knows every command.
The skill is the SKILL.md in the package. It tells Codex what each command does and which ones ask first.
```
mkdir -p ~/.agents/skills/facebook-mcp
cp "$(npm root -g)/@thenavidm/facebook-mcp-cli/SKILL.md" ~/.agents/skills/facebook-mcp/
```
3
Check your setup.
It names anything that's wrong and the fix.
```
facebook-cli doctor
```
4
Ask Codex to use facebook-cli.
Running facebook-cli on its own lists every command, so Codex finds the one it needs.

Install the CLI. It needs Node 22 or newer.

npm install -g @thenavidm/facebook-mcp-cli@latest

2
Check your setup.
It names anything that's wrong and the fix.
```
facebook-cli doctor
```
3
Ask Cursor to use facebook-cli.
Running facebook-cli on its own lists every command, so Cursor finds the one it needs.

Install the CLI. It needs Node 22 or newer.

npm install -g @thenavidm/facebook-mcp-cli@latest

2
Check your setup.
It names anything that's wrong and the fix.
```
facebook-cli doctor
```
3
Ask VS Code to use facebook-cli.
Running facebook-cli on its own lists every command, so VS Code finds the one it needs.

Your computer

macOS Windows Linux

Install the CLI. It needs Node 22 or newer.

npm install -g @thenavidm/facebook-mcp-cli@latest

2
Give Copilot CLI the skill, so it knows every command.
The skill is the SKILL.md in the package. It tells Copilot CLI what each command does and which ones ask first.
```
mkdir -p ~/.copilot/skills/facebook-mcp
cp "$(npm root -g)/@thenavidm/facebook-mcp-cli/SKILL.md" ~/.copilot/skills/facebook-mcp/
```
3
Check your setup.
It names anything that's wrong and the fix.
```
facebook-cli doctor
```
4
Ask Copilot CLI to use facebook-cli.
Running facebook-cli on its own lists every command, so Copilot CLI finds the one it needs.

Install the CLI. It needs Node 22 or newer.

npm install -g @thenavidm/facebook-mcp-cli@latest

Give Copilot CLI the skill, so it knows every command.

The skill is the SKILL.md in the package. It tells Copilot CLI what each command does and which ones ask first.

New-Item -ItemType Directory -Force "$HOME\.copilot\skills\facebook-mcp" | Out-Null
Copy-Item "$(npm root -g)\@thenavidm\facebook-mcp-cli\SKILL.md" "$HOME\.copilot\skills\facebook-mcp\"

3
Check your setup.
It names anything that's wrong and the fix.
```
facebook-cli doctor
```
4
Ask Copilot CLI to use facebook-cli.
Running facebook-cli on its own lists every command, so Copilot CLI finds the one it needs.

Install the CLI. It needs Node 22 or newer.

npm install -g @thenavidm/facebook-mcp-cli@latest

2
Give Copilot CLI the skill, so it knows every command.
The skill is the SKILL.md in the package. It tells Copilot CLI what each command does and which ones ask first.
```
mkdir -p ~/.copilot/skills/facebook-mcp
cp "$(npm root -g)/@thenavidm/facebook-mcp-cli/SKILL.md" ~/.copilot/skills/facebook-mcp/
```
3
Check your setup.
It names anything that's wrong and the fix.
```
facebook-cli doctor
```
4
Ask Copilot CLI to use facebook-cli.
Running facebook-cli on its own lists every command, so Copilot CLI finds the one it needs.

Install the CLI. It needs Node 22 or newer.

npm install -g @thenavidm/facebook-mcp-cli@latest

2
Check your setup.
It names anything that's wrong and the fix.
```
facebook-cli doctor
```
3
Ask Gemini CLI to use facebook-cli.
Running facebook-cli on its own lists every command, so Gemini CLI finds the one it needs.

Your computer

macOS Windows Linux

Install the CLI. It needs Node 22 or newer.

npm install -g @thenavidm/facebook-mcp-cli@latest

2
Give OpenCode the skill, so it knows every command.
The skill is the SKILL.md in the package. It tells OpenCode what each command does and which ones ask first.
```
mkdir -p ~/.config/opencode/skills/facebook-mcp
cp "$(npm root -g)/@thenavidm/facebook-mcp-cli/SKILL.md" ~/.config/opencode/skills/facebook-mcp/
```
3
Check your setup.
It names anything that's wrong and the fix.
```
facebook-cli doctor
```
4
Ask OpenCode to use facebook-cli.
Running facebook-cli on its own lists every command, so OpenCode finds the one it needs.

Install the CLI. It needs Node 22 or newer.

npm install -g @thenavidm/facebook-mcp-cli@latest

Give OpenCode the skill, so it knows every command.

The skill is the SKILL.md in the package. It tells OpenCode what each command does and which ones ask first.

New-Item -ItemType Directory -Force "$HOME\.config\opencode\skills\facebook-mcp" | Out-Null
Copy-Item "$(npm root -g)\@thenavidm\facebook-mcp-cli\SKILL.md" "$HOME\.config\opencode\skills\facebook-mcp\"

3
Check your setup.
It names anything that's wrong and the fix.
```
facebook-cli doctor
```
4
Ask OpenCode to use facebook-cli.
Running facebook-cli on its own lists every command, so OpenCode finds the one it needs.

Install the CLI. It needs Node 22 or newer.

npm install -g @thenavidm/facebook-mcp-cli@latest

2
Give OpenCode the skill, so it knows every command.
The skill is the SKILL.md in the package. It tells OpenCode what each command does and which ones ask first.
```
mkdir -p ~/.config/opencode/skills/facebook-mcp
cp "$(npm root -g)/@thenavidm/facebook-mcp-cli/SKILL.md" ~/.config/opencode/skills/facebook-mcp/
```
3
Check your setup.
It names anything that's wrong and the fix.
```
facebook-cli doctor
```
4
Ask OpenCode to use facebook-cli.
Running facebook-cli on its own lists every command, so OpenCode finds the one it needs.

Your computer

macOS Windows Linux

Install the CLI. It needs Node 22 or newer.

npm install -g @thenavidm/facebook-mcp-cli@latest

2
Give OpenClaw the skill, so it knows every command.
The skill is the SKILL.md in the package. It tells OpenClaw what each command does and which ones ask first.
```
mkdir -p ~/.openclaw/skills/facebook-mcp
cp "$(npm root -g)/@thenavidm/facebook-mcp-cli/SKILL.md" ~/.openclaw/skills/facebook-mcp/
```
3
Check your setup.
It names anything that's wrong and the fix.
```
facebook-cli doctor
```
4
Ask OpenClaw to use facebook-cli.
Running facebook-cli on its own lists every command, so OpenClaw finds the one it needs.

Install the CLI. It needs Node 22 or newer.

npm install -g @thenavidm/facebook-mcp-cli@latest

Give OpenClaw the skill, so it knows every command.

The skill is the SKILL.md in the package. It tells OpenClaw what each command does and which ones ask first.

New-Item -ItemType Directory -Force "$HOME\.openclaw\skills\facebook-mcp" | Out-Null
Copy-Item "$(npm root -g)\@thenavidm\facebook-mcp-cli\SKILL.md" "$HOME\.openclaw\skills\facebook-mcp\"

3
Check your setup.
It names anything that's wrong and the fix.
```
facebook-cli doctor
```
4
Ask OpenClaw to use facebook-cli.
Running facebook-cli on its own lists every command, so OpenClaw finds the one it needs.

Install the CLI. It needs Node 22 or newer.

npm install -g @thenavidm/facebook-mcp-cli@latest

2
Give OpenClaw the skill, so it knows every command.
The skill is the SKILL.md in the package. It tells OpenClaw what each command does and which ones ask first.
```
mkdir -p ~/.openclaw/skills/facebook-mcp
cp "$(npm root -g)/@thenavidm/facebook-mcp-cli/SKILL.md" ~/.openclaw/skills/facebook-mcp/
```
3
Check your setup.
It names anything that's wrong and the fix.
```
facebook-cli doctor
```
4
Ask OpenClaw to use facebook-cli.
Running facebook-cli on its own lists every command, so OpenClaw finds the one it needs.

Install the CLI. It needs Node 22 or newer.

npm install -g @thenavidm/facebook-mcp-cli@latest

2
Check your setup.
It names anything that's wrong and the fix.
```
facebook-cli doctor
```
3
Ask Antigravity to use facebook-cli.
Running facebook-cli on its own lists every command, so Antigravity finds the one it needs.

Install the CLI. It needs Node 22 or newer.

npm install -g @thenavidm/facebook-mcp-cli@latest

2
Check your setup.
It names anything that's wrong and the fix.
```
facebook-cli doctor
```
3
Ask Hermes to use facebook-cli.
Running facebook-cli on its own lists every command, so Hermes finds the one it needs.

Install the CLI. It needs Node 22 or newer.

npm install -g @thenavidm/facebook-mcp-cli@latest

2
Check your setup.
It names anything that's wrong and the fix.
```
facebook-cli doctor
```
3
List every command, then try one.
```
facebook-cli
facebook-cli list-pages
```

Needs Node 22 or newer and your own Meta app, made once in about 10 minutes. Set it up.

It's free and open source. If it saves you time, star it on GitHub, so more people find it.

Beoordeel deze tool

Facebook MCP Server & CLI

Add it with a single command in a terminal.

In Claude Code, type /mcp. Facebook should show as connected.

Add it with a single command in a terminal.

In Claude Code, type /mcp. Facebook should show as connected.

Add it with a single command in a terminal.

In Claude Code, type /mcp. Facebook should show as connected.

Download the Claude Desktop extension.

Double-click it, and Claude Desktop installs it.

Add it with a single command in a terminal.

Check that Codex lists it.

Add it with a single command in a terminal.

Check that Codex lists it.

Add it with a single command in a terminal.

Check that Codex lists it.

Open Cursor's settings, go to the MCP tab, and click Add new global MCP server.

Add the server.

Open the MCP tab again. It should show 15 tools.

Open the Command Palette and run MCP: Open User Configuration.

Add the server to that mcp.json.

Add it with a single command in a terminal.

Check that Copilot CLI has it.

Add it with a single command in a terminal.

Check that Copilot CLI has it.

Add it with a single command in a terminal.

Check that Copilot CLI has it.

Open your Gemini CLI settings.

Add the server to settings.json.

Restart Gemini CLI and type /mcp to check it.

Open your Gemini CLI settings.

Add the server to settings.json.

Restart Gemini CLI and type /mcp to check it.

Open your Gemini CLI settings.

Add the server to settings.json.

Restart Gemini CLI and type /mcp to check it.

Open your OpenCode config.

Add the server under mcp.

Restart OpenCode.

Open your OpenCode config.

Add the server under mcp.

Restart OpenCode.

Open your OpenCode config.

Add the server under mcp.

Restart OpenCode.

Add it with a single command in a terminal.

Check that it starts and lists its tools.

Add it with a single command in a terminal.

Check that it starts and lists its tools.

Add it with a single command in a terminal.

Check that it starts and lists its tools.

In the agent panel, click the … menu, then MCP Servers, Manage MCP Servers and View raw config.

Add the server to mcp_config.json.

Open your Hermes config.

Add the server under mcp_servers.

Open your Hermes config.

Add the server under mcp_servers.

Open your Hermes config.

Add the server under mcp_servers.

Install the CLI. It needs Node 22 or newer.

Give Claude Code the skill, so it knows every command.

Check your setup.

Ask Claude Code to use facebook-cli.

Install the CLI. It needs Node 22 or newer.

Give Claude Code the skill, so it knows every command.

Check your setup.

Ask Claude Code to use facebook-cli.

Install the CLI. It needs Node 22 or newer.

Give Claude Code the skill, so it knows every command.

Check your setup.

Ask Claude Code to use facebook-cli.

Install the CLI. It needs Node 22 or newer.

Give Codex the skill, so it knows every command.

Check your setup.

Ask Codex to use facebook-cli.

Install the CLI. It needs Node 22 or newer.

Give Codex the skill, so it knows every command.

Check your setup.

Ask Codex to use facebook-cli.

Install the CLI. It needs Node 22 or newer.

Give Codex the skill, so it knows every command.