Windsurf + Bluesky
Post to Bluesky from Windsurf
Ask Windsurf to write and schedule your Bluesky posts. BrokenPost connects the two, follows Bluesky's rules and posts at the time you pick.
How to connect Windsurf to Bluesky
- 1
Connect Bluesky in BrokenPost. Add your Bluesky handle and an app password.
- 2
In BrokenPost, open Plugins and copy your MCP URL.
- 3
Add the config below to ~/.codeium/windsurf/mcp_config.json.
- 4
Sign in to BrokenPost when asked and allow access.
- 5
Ask the agent to schedule a post.
{
"mcpServers": {
"brokenpost": { "serverUrl": "<MCP_URL>" }
}
}What to ask Windsurf
Type these in Windsurf. Change the details to fit your posts.
- “Post this on Bluesky tomorrow at 9am as a 3-part thread.”
- “Share these 4 pictures on Bluesky on Saturday with a one-line caption.”
- “Shorten my last X post to fit Bluesky and schedule it for tonight.”
- “Read the commits since the last tag and turn them into a short Bluesky post. Schedule it for 10am tomorrow.”
- “What Bluesky posts do I have scheduled for next week?”
What happens next
- 1
You ask in Windsurf, in plain words.
- 2
Windsurf lists the channels you connected in BrokenPost and picks your Bluesky account.
- 3
It reads Bluesky's rules and settings from BrokenPost, so the post fits Bluesky's limits before it is written.
- 4
If you shared a picture, a video or a link to one, it uploads it to your media library.
- 5
It creates the post as scheduled, as a draft, or to go out now, and gives you a preview link.
- 6
At the set time BrokenPost publishes it to Bluesky and it shows on your calendar.
Bluesky limits Windsurf follows
Windsurf reads these rules from BrokenPost before it writes, so the post fits the first time.
| Characters | 300 characters |
|---|---|
| Media | Up to 4 pictures or 1 video, or text only |
| Pictures | Up to 4 |
| Video | 1, no other media |
| Threads | Yes, as replies |
If Bluesky rejects a post
Windsurf sees the same message and can fix the post for you.
| What you see | How to fix it |
|---|---|
| You can only upload one video per post. | Keep one video, or switch to pictures only. |
| There can be maximum 4 pictures in a post. | Remove pictures until there are 4 or fewer. |
Good to know
- Bluesky posts are short: 300 characters per part.
- One video, or up to 4 pictures. Not both.
- Windsurf only posts when you ask. Ask for a draft to check the post in BrokenPost first.
Questions people ask
Can Windsurf post to Bluesky directly?
Yes, through BrokenPost. Connect Bluesky in BrokenPost, connect BrokenPost to Windsurf, and Windsurf can schedule, draft or publish Bluesky posts.
Does Windsurf know the Bluesky limits?
Yes. Windsurf reads Bluesky's rules from BrokenPost before it writes: 300 characters and up to 4 pictures or 1 video, or text only. BrokenPost checks again before it posts.
Can Windsurf schedule Bluesky posts for later?
Yes. Give a day and time, like "Friday at 6pm", and the post goes out then. Ask for a draft if you want to check it first.
Is it free?
Windsurf with BrokenPost works on every plan. The Free plan includes 1 account on every app and 20 posts a month. Paid plans start at $19 a month with unlimited posts.
Can Windsurf post a Bluesky thread or comments?
Yes. Ask for a thread or a first comment and BrokenPost posts each part as a reply, right after the first one.
Do I need my main Bluesky password?
No. Make an app password in your Bluesky settings and use that. You can remove it any time.
More apps with Windsurf
Post to Bluesky with other AI
Write once. Post everywhere.
Start free with BrokenPost. Connect your apps and your AI in a few minutes.