NEW: the postqueen MCP server is live. Connect it in a minute
Mastodon

Automate Mastodon with Claude

Ask Claude for Mastodon posts and it schedules them through postqueen. Add the connector once on the web and the same tools answer on your phone.

Quick start

Add postqueen as a connector on claude.ai and Mastodon scheduling is available in every chat, including the phone apps.

MCP supported
Custom connector
# claude.ai, Settings, then Connectors
# Add a custom connector:
 
https://api.postqueen.ai/mcp/YOUR_API_KEY
 
# Then ask:
# "Draft three Mastodon posts for this
# week and put them on the calendar"

What Claude can run on Mastodon

Mastodon from any device

The connector belongs to your Claude account rather than a machine, so the same Mastodon tools answer on the web, on the desktop and in the phone apps.

Windows that fit Mastodon

Tell Claude 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 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

Step 1

Discover Mastodon

Claude calls postqueen to list your connected instances and accounts and sees what Mastodon supports, so drafts start from real capabilities, not guesses.

Step 2

Draft with Claude

Give it the brief. The agent writes Mastodon-shaped posts and proposes publish times that match when your followers are around.

Step 3

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 can pull the results after.

What Mastodon allows

Claude 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
Mastodon

Everything postqueen does on Mastodon

Scheduling, AI drafts, analytics and team roles, in one guide.

Read the Mastodon guide
F.A.Q.

Frequently asked questions

How does Claude connect Mastodon to postqueen?

Over MCP, as a custom connector added once on claude.ai. Claude has no terminal, so there is no CLI to install: the connector carries your API key and the Mastodon tools then answer in the desktop and phone apps too.

Can Claude 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 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 can turn the same brief into Mastodon posts plus adapted versions for every other channel you run.

Does Claude 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.

Why did my scheduled Mastodon post fail?

Common causes are media above your server's upload limits, a server character limit lower than your draft, a revoked token, or the instance being temporarily down. Fix the post or reconnect the account and schedule it again.

Can I try Mastodon scheduling for free?

Yes. Cloud plans start with a 7-day free trial and unlimited posts. And since postqueen is open source under AGPL-3.0, self-hosting is free if you would rather keep everything on your own infrastructure.

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.