Mastodon tools in your terminal
Over MCP, scheduling and analytics show up as first-class tools. Over the CLI, every command returns JSON that Claude Code can chain reliably for Mastodon.
MastodonAutomate Mastodon with Claude Code
Queue Mastodon posts from your terminal. Claude Code drives postqueen over MCP or the CLI, so scheduling happens in the session you already have open.
Quick start
Register the postqueen MCP server once and Mastodon scheduling becomes a tool Claude Code can call. The plain CLI works too.
MCP supportedTerminal
# Add the postqueen MCP serverclaude mcp add --transport http postqueen \ https://api.postqueen.ai/mcp/YOUR_API_KEY # Then ask in your session:# "Queue three Mastodon posts for this# week, mornings at 9"What Claude Code can run on Mastodon
Windows that fit Mastodon
Tell Claude Code when your followers are most active and it schedules posts into that window on Mastodon, day after day, without reminders.
Media attached, sized right
Images upload in the same postqueen call, so Mastodon posts arrive with their media in place instead of a bare link.
Drafts until you are ready
Ask Claude Code for drafts only. They sit on the postqueen calendar unscheduled, so you can edit them and pick the time yourself, and nothing reaches your followers on Mastodon until you do.
Three steps to a full queue
Discover Mastodon
Claude Code calls postqueen to list your connected instances and accounts and sees what Mastodon supports, so drafts start from real capabilities, not guesses.
Draft with Claude Code
Give it the brief. The agent writes Mastodon-shaped posts and proposes publish times that match when your followers are around.
Check and publish
Look over the queue on the postqueen calendar and change anything you want. postqueen publishes each post at its time, and Claude Code can pull the results after.
What Mastodon allows
Claude Code reads these limits from postqueen before it composes, so a draft that would be rejected never reaches the queue.
- Post length
- 500 characters on standard servers (admins can raise this)
- Attachments
- Up to 4 images, or one video or audio file per post
- Visibility
- Public, unlisted, followers only, or direct
- Content warnings
- A native CW field is available on every post
- Polls
- Up to 4 options on standard servers
- Servers
- Any Mastodon instance works, you authorize postqueen on your own server
MastodonEverything postqueen does on Mastodon
Scheduling, AI drafts, analytics and team roles, in one guide.
F.A.Q.
Frequently asked questions
How does Claude Code connect Mastodon to postqueen?
Over MCP, registered once in Claude Code's own config so the Mastodon tools are there in every session. It also runs commands, so the CLI covers the same Mastodon posts when you would rather script them; both use the same API key.
Can Claude Code schedule Mastodon posts at exact times?
Yes. Give it exact slots or a rule like mornings at nine and it sets publish times on the posts it creates, so your followers see them at the right moment.
Will Claude Code publish to Mastodon on its own?
Only if you ask it to. Tell it to save drafts and nothing is scheduled: the posts wait on the calendar until you set a time. Tell it to schedule, and they go out at the times you can see, which is the setup most people move to once they trust the output.
Can one brief cover Mastodon and other channels too?
Yes. postqueen connects 30 channels, so Claude Code can turn the same brief into Mastodon posts plus adapted versions for every other channel you run.
Does Claude Code access cost extra on postqueen?
No. The agent uses your regular API key and plan limits: unlimited posts on every plan, and channel counts from 5 on Creator up to uncapped on Ultimate.
When is the best time to post on Mastodon?
Your followers are scattered across servers and timezones, so consistency beats any magic hour. Schedule regular slots, including times you are normally offline, and use analytics to see which windows earn boosts and replies.
Can I cross-post to Bluesky, Threads and X as well?
Yes. Write once, select all your microblogging channels, and adjust each version before it goes live. Mastodon's roomier 500 character default means you may want to trim the copies headed to tighter networks.
Ready to get started?
Queue this week's posts in minutes, or hand the whole thing to your favorite AI. postqueen keeps publishing either way.
Seven days free. Cancel in one click from settings.