Schedule Pinterest posts from Claude Code

Add Hookpost to Claude Code as a remote MCP server added with one claude mcp add command and 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

  1. Copy your Hookpost API key. In Hookpost, open Settings → Developers → Reveal → Copy.
  2. Add the server. Run the command below with your key in place of YOUR_API_KEY, then check it with claude mcp list.
  3. Connect Pinterest. Ask Claude Code 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.

Terminal

claude mcp add --transport http hookpost https://hookpost.hookstep.in/api/mcp \
  --header "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. Claude Code 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 Claude Code. 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 CHANGELOG.md, within Pinterest's limits.
Save it as a draft in Hookpost. Do not schedule or publish anything.

What happens behind it

  1. list_channels finds your Pinterest channel and its id.
  2. 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.
  3. get_platform_post_rules returns Pinterest's limit and the settings a post takes.
  4. list_pinterest_boards lists where the post can go, for the setting it needs.
  5. create_post saves the post as a draft, schedules it for a time, or publishes it now.

Questions

Can Claude Code 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 Claude Code 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 Claude Code not do in Hookpost?
Delete posts, edit the text or date of a post, or read analytics. Do those in the Hookpost app.

Related