Schedule Pinterest posts from Gemini CLI
Add Hookpost to Gemini CLI as a remote MCP server in ~/.gemini/settings.json (httpUrl), with your API key. Then ask it for a Pinterest post: it saves a draft, schedules it, or publishes it now to a board on your Pinterest account. If Pinterest is not connected yet, it gives you a link that connects it in about a minute.
By the Hookpost team ·
Set it up in 3 steps
- Copy your Hookpost API key. In Hookpost, open Settings → Developers → Reveal → Copy.
- Add the server. Paste the block below into ~/.gemini/settings.json with your key in place of YOUR_API_KEY.
- Connect Pinterest. Ask Gemini CLI to connect Pinterest. It replies with a link; open it, approve on Pinterest's screen, and the channel is in Hookpost. You can also use Add Channel in the app.
~/.gemini/settings.json
{
"mcpServers": {
"hookpost": {
"httpUrl": "https://hookpost.hookstep.in/api/mcp",
"headers": { "Authorization": "Bearer YOUR_API_KEY" }
}
}
}Claude Code, Cursor, VS Code, Windsurf, Codex, Gemini CLI and the hookpost CLI use an API key, which comes with the Hookpost plan.
What Pinterest accepts
Text limit: 500 characters. Gemini CLI reads these from get_platform_post_rules before it writes, so the draft fits.
- At least one image or video per Pin
- Up to 5 media items
- Video Pins need a cover image as the second item
A first prompt
Paste this into Gemini CLI. It stops at a draft, so nothing goes out until you look at it.
Prompt
List my Hookpost channels. If Pinterest is not connected, give me the link to connect it and wait. Then write a Pin title and description for the image at the URL I give you, based on README.md, within Pinterest's limits. Save it as a draft in Hookpost. Do not schedule or publish anything.
What happens behind it
- list_channels finds your Pinterest channel and its id.
- If there is none, create_channel_connect_link returns a link: you open it, approve on Pinterest's own screen, and the channel is added. The link works for 24 hours.
- get_platform_post_rules returns Pinterest's limit and the settings a post takes.
- list_pinterest_boards lists where the post can go, for the setting it needs.
- create_post saves the post as a draft, schedules it for a time, or publishes it now.
Questions
- Can Gemini CLI post to Pinterest on its own?
- Yes, through Hookpost's create_post tool: as a draft, at a scheduled time, or right away. It posts to a board on your Pinterest account only after you have connected it, and the prompt above keeps it to drafts until you review them in the Hookpost calendar.
- Do I need my own Pinterest developer app or API key?
- No. Hookpost holds the Pinterest app; you approve Hookpost once on Pinterest's sign-in screen, from the link Gemini CLI gives you or from Add Channel.
- What does it need on the Hookpost side?
- Claude Code, Cursor, VS Code, Windsurf, Codex, Gemini CLI and the hookpost CLI use an API key, which comes with the Hookpost plan.
- What can Gemini CLI not do in Hookpost?
- Delete posts, edit the text or date of a post, or read analytics. Do those in the Hookpost app.
Related
- Pinterest in Hookpost
Everything Hookpost does on Pinterest.
- Full Gemini CLI setup
Every option for Gemini CLI, step by step.
- Every agent and network
The other agents and networks.
- The Hookpost MCP server
Endpoints and the full tool list.