Mastodon commands it can verify
Gemini CLI runs postqueen and reads the JSON back, so it can confirm which Mastodon posts exist and at what times instead of reporting success it did not check.
MastodonAutomate Mastodon with Gemini CLI
Queue Mastodon posts from the terminal. Gemini CLI runs every postqueen command and reads the JSON back, so it can check what it scheduled.
Quick start
Run the postqueen CLI directly, or add the MCP endpoint to your Gemini CLI settings and ask for Mastodon posts in plain language.
MCP supportedTerminal or settings.json
npm install -g postqueenexport POSTQUEEN_API_KEY=your_api_key # Or MCP, in your Gemini CLI settings:# { "mcpServers": { "postqueen": {# "url": "https://api.postqueen.ai/mcp/KEY"# } } }What Gemini CLI can run on Mastodon
Windows that fit Mastodon
Tell Gemini CLI 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 Gemini CLI 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
Gemini CLI calls postqueen to list your connected instances and accounts and sees what Mastodon supports, so drafts start from real capabilities, not guesses.
Draft with Gemini CLI
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 Gemini CLI can pull the results after.
What Mastodon allows
Gemini CLI 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 Gemini CLI connect Mastodon to postqueen?
Over MCP, registered once in Gemini CLI'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 Gemini CLI 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 Gemini CLI 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 Gemini CLI can turn the same brief into Mastodon posts plus adapted versions for every other channel you run.
Does Gemini CLI 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 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.
What Mastodon formats can postqueen schedule?
Text posts, galleries of up to 4 images, video, and full threads that publish as native reply chains. Upload media straight into the composer and preview the post before it goes out.
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.