How to post to a Facebook Page from Claude Code

Set it up and post, step by step

Prompt to copy once your Page is connected: Read NOTES.md, write a Facebook post for our Saturday open day with the time and the address, show it to me, and schedule it for Friday at 9am with ./assets/open-day.jpg.

1. Add PostWire to Claude Code

   In your terminal run claude mcp add --transport http postwire https://postwire.io/api/mcp (add --scope user to have it in every project), then type /mcp in Claude Code and pick postwire to sign in. The sign-in asks for your email and a 6-digit code, which also creates a free PostWire account if you have none: no password and no card.

2. Or install the skill instead

   npx skills add https://postwire.io --skill schedule-posts adds PostWire's scheduling skill to Claude Code (and to the other agents on the machine). It uses your key from the environment: copy it in the dashboard under API & MCP and set POSTWIRE_API_KEY. The skill is a plain file you can read first: schedule-posts/SKILL.md.

3. Connect your Facebook Page

   Ask "connect my Facebook Page". Claude Code calls create_connect_link and prints a one-hour link; open it and choose Facebook. Facebook shows "Continue as <your name>", then asks which Pages PostWire may use: tick the Page and press Save. Pages you manage directly and Pages inside a Business Portfolio both appear. PostWire never sees your Facebook password.

4. Ask for the post

   "Write the Facebook post for the open day." generate_posts returns a draft and publishes nothing. It is written for Facebook: 40 to 80 characters when the idea allows and under 250 otherwise, the hook in the first 125 characters (where the mobile feed cuts), 1 to 3 hashtags, and a link can stay in the body. Ask for the Instagram or LinkedIn version in the same sentence and each comes back written for its own network.

5. Post now, or schedule it

   Say "post it" and Claude Code calls post_to_social. Say "schedule it for Friday at 9am" and it calls schedule_post, up to 365 days ahead, or with run_at: "next_slot" for your next free posting hour. A photo or a video goes as its public https link in photo_url or video_url. A file on your computer goes through an upload page: ask for one (create_upload_link), pick the file there, and Claude Code gets its link. One file can be up to 100 MB on the free plan and 1 GB on paid plans. This is the call:

   {
     "name": "schedule_post",
     "arguments": {
       "platforms": ["facebook"],
       "per_platform": { "facebook": {
         "text": "Open day this Saturday, 10 to 2, at 41 Main St. Coffee is on us ☕ #openday"
       } },
       "photo_url": "https://postwire.io/m/…/open-day.jpg",
       "run_at": "2026-10-23T09:00:00-05:00"
     }
   }

6. Check that it went out

   The result lists Facebook with ok, the Page it went to and the post's link (https://facebook.com/…). If Facebook refuses it, the result carries what happened and the fix.

"What's scheduled on Facebook?" calls list_scheduled_posts and "cancel Friday's post" calls cancel_scheduled_post; the same queue is on the dashboard's Queue page, with Reschedule. Prefer to set it up by hand first? Open the dashboard, connect the account under Accounts and copy your key under API & MCP.