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

Automate Mastodon with Hermes

Hand Hermes one brief and it plans the whole week: drafting Mastodon posts, scheduling them at the right times and reporting back when the queue is full.

Quick start

Install the CLI where Hermes executes commands, then hand over the Mastodon plan in plain language.

Terminal
npm install -g postqueen
export POSTQUEEN_API_KEY=your_api_key
 
# A task for Hermes:
# "Plan next week on Mastodon: draft five
# posts, schedule them and list
# what you queued"

What Hermes can run on Mastodon

One brief, a full Mastodon plan

Hermes breaks a goal into steps on its own: draft the posts, upload media, schedule each one and report back with what it queued for Mastodon.

Windows that fit Mastodon

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

Hermes 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 Hermes

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

What Mastodon allows

Hermes 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 Hermes connect Mastodon to postqueen?

Install the postqueen CLI where Hermes runs commands and export your API key. Every command returns JSON, so the agent can create, schedule and list Mastodon posts reliably.

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

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

Which Mastodon servers does postqueen work with?

All of them. Enter your server's URL, sign in and authorize the app on your own instance, and repeat for accounts on other servers if you have them. Each connected account counts as one channel on your plan.

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.

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.