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

Automate Mastodon with ChatGPT

Draft Mastodon posts in ChatGPT, then let postqueen schedule and publish them. One conversation in, a full Mastodon queue out.

Quick start

Point a custom GPT action at the public API, or let agent modes that run commands use the CLI for Mastodon.

Custom GPT or CLI
# Custom GPT action: call the public API
POST https://api.postqueen.ai/public/v1/posts
Authorization: your_api_key
 
# Or in agent modes that run commands:
npm install -g postqueen
postqueen posts:create --json mastodon-week.json

What ChatGPT can run on Mastodon

From ChatGPT draft to Mastodon queue

The writing already happens in ChatGPT. With the public API or the CLI, the same conversation can create scheduled Mastodon posts instead of text to paste.

Windows that fit Mastodon

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

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

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

What Mastodon allows

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

Through the public API from a custom GPT action, or through the CLI in agent modes that execute commands. Both use the same API key and cover Mastodon posts end to end.

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

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

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.

Can the AI assistant write Mastodon posts?

Yes. Drafts come out plain and human, which is what fediverse audiences expect, and stay within the standard 500 character limit. You choose when every post goes out, in the app, from the CLI, or through an agent using the MCP server.

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.