Claude Code + Bluesky
Post to Bluesky from Claude Code
Ask Claude Code 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 Claude Code 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
Run the command below in your terminal.
- 4
Run /mcp in Claude Code and sign in to BrokenPost.
- 5
Ask Claude Code to schedule a post.
claude mcp add brokenpost --transport http "<MCP_URL>"Prefer another way? See every way to connect Claude Code.
What to ask Claude Code
Type these in Claude Code. 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 Claude Code, in plain words.
- 2
Claude Code 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 Claude Code follows
Claude Code 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
Claude Code 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.
- Claude Code only posts when you ask. Ask for a draft to check the post in BrokenPost first.
Questions people ask
Can Claude Code post to Bluesky directly?
Yes, through BrokenPost. Connect Bluesky in BrokenPost, connect BrokenPost to Claude Code, and Claude Code can schedule, draft or publish Bluesky posts.
Does Claude Code know the Bluesky limits?
Yes. Claude Code 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 Claude Code 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?
Claude Code 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 Claude Code 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 Claude Code
Post to Bluesky with other AI
Write once. Post everywhere.
Start free with BrokenPost. Connect your apps and your AI in a few minutes.