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

Automate Nostr with Gemini CLI

Queue Nostr 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 Nostr posts in plain language.

MCP supported
Terminal or settings.json
npm install -g postqueen
export 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 Nostr

Nostr commands it can verify

Gemini CLI runs postqueen and reads the JSON back, so it can confirm which Nostr posts exist and at what times instead of reporting success it did not check.

Windows that fit Nostr

Tell Gemini CLI when your followers are most active and it schedules posts into that window on Nostr, day after day, without reminders.

Media attached, sized right

Images upload in the same postqueen call, so Nostr 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 Nostr until you do.

Three steps to a full queue

Step 1

Discover Nostr

Gemini CLI calls postqueen to list your connected keys and relays and sees what Nostr supports, so drafts start from real capabilities, not guesses.

Step 2

Draft with Gemini CLI

Give it the brief. The agent writes Nostr-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 Gemini CLI can pull the results after.

What Nostr allows

Gemini CLI reads these limits from postqueen before it composes, so a draft that would be rejected never reaches the queue.

Identity
A keypair (npub and nsec), with no email, signup or account approval
Note length
The protocol sets no character limit on text notes, though relays can cap event size
Media
Images and video are linked by URL and rendered inline by most clients
Relays
A note only exists on the relays you publish it to, so most people use several
Threads
Replies reference the parent event, so clients render them as native threads
Portability
The same key works in Damus, Amethyst, Primal and every other client
Nostr

Everything postqueen does on Nostr

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

Read the Nostr guide
F.A.Q.

Frequently asked questions

How does Gemini CLI connect Nostr to postqueen?

Over MCP, registered once in Gemini CLI's own config so the Nostr tools are there in every session. It also runs commands, so the CLI covers the same Nostr posts when you would rather script them; both use the same API key.

Can Gemini CLI schedule Nostr 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 Nostr 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 Nostr and other channels too?

Yes. postqueen connects 30 channels, so Gemini CLI can turn the same brief into Nostr 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.

Is there a free trial?

Yes. Every cloud plan starts with a 7-day free trial with unlimited posts, and you can cancel anytime. Self-hosting the open source version stays free either way.

What can postqueen publish to Nostr?

Text notes, notes with images or video linked in, and multi-part threads that clients render as a proper reply chain. You compose once, pick the time, and postqueen broadcasts the event to your relays. Nostr has no upload server of its own, so media travels as a URL and clients unfurl it inline.

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.