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

Automate Pinterest with Gemini CLI

Queue Pinterest pins 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 Pinterest pins 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 Pinterest

Pinterest commands it can verify

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

Windows that fit Pinterest

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

Media attached, sized right

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

Three steps to a full queue

Step 1

Discover Pinterest

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

Step 2

Draft with Gemini CLI

Give it the brief. The agent writes Pinterest-shaped pins 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 Pinterest allows

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

Pin titles
Up to 100 characters
Pin descriptions
Up to 500 characters
Image ratio
2:3 recommended, for example 1000 x 1500 px
Image files
JPG or PNG up to 20 MB
Video pins
4 seconds to 15 minutes, files up to 2 GB
Boards and links
Every pin saves to a board and can carry a destination link
Pinterest

Everything postqueen does on Pinterest

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

Read the Pinterest guide
F.A.Q.

Frequently asked questions

How does Gemini CLI connect Pinterest to postqueen?

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

Can Gemini CLI schedule Pinterest pins at exact times?

Yes. Give it exact slots or a rule like mornings at nine and it sets publish times on the pins it creates, so your followers see them at the right moment.

Will Gemini CLI publish to Pinterest on its own?

Only if you ask it to. Tell it to save drafts and nothing is scheduled: the pins 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 Pinterest and other channels too?

Yes. postqueen connects 30 channels, so Gemini CLI can turn the same brief into Pinterest pins 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 Pinterest scheduling for free?

Yes. Every cloud plan starts with a 7-day free trial, includes unlimited posts, and can be canceled anytime. Self-hosting the open source version is free.

What Pinterest formats can postqueen schedule?

Image pins and video pins, each with a title, description, destination link and target board. You pick the board per pin, so one batch can fill several boards at once.

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.