Post to Pinterest from Claude Code
Claude Code is Anthropic's coding agent. It runs in your terminal and in VS Code and JetBrains; developers use it to work on code and to call tools over MCP. A video pin with a cover picture, on one of your boards.
Connect Claude Code to Kreatix
Sign in with Kreatix
No key to copy: paste the address, sign in to Kreatix and press Allow.
- Run once in a terminal: claude mcp add --transport http --scope user kreatix https://api.kreatix.cc/mcp
- Start claude and type /mcp. Finish the sign-in for kreatix in your browser: sign in to Kreatix and press Allow. From a plain shell, claude mcp login kreatix does the same.
- Check with claude mcp list: kreatix should show Connected.
claude mcp add --transport http --scope user kreatix https://api.kreatix.cc/mcpWith a key
For setups without sign-in. The key works like a password, so keep it to yourself.
- In Kreatix, open Settings > AI agent and create a key. It is shown once.
- Run once in a terminal: claude mcp add --transport http --scope user kreatix https://api.kreatix.cc/mcp --header "Authorization: Bearer YOUR_KEY"
- Check with claude mcp list: kreatix should show Connected.
claude mcp add --transport http --scope user kreatix https://api.kreatix.cc/mcp --header "Authorization: Bearer YOUR_KEY"What Claude Code can do on Pinterest
A video pin with a cover picture, on one of your boards.
| Setting | Values | Needed | What it does |
|---|---|---|---|
media_url | URL | Yes | The pin's video: a link from your Kreatix library or a public YouTube, TikTok, Instagram or Facebook post, which Kreatix imports first. |
cover_url | URL | Yes | The pin's cover, a picture stored in Kreatix. With an imported link and no cover, Kreatix uses the link's thumbnail; a link without one is refused. |
caption | string (max 5000) | No | The first 100 characters become the pin title and the first 800 the description. |
Ask in plain words
Ask inside a claude session, or as a one-liner from the terminal: claude -p "Which of my Kreatix pages got the most views this week?" --allowedTools "mcp__kreatix__get_stats"
claude -p "Pin my newest video to Pinterest tomorrow at 20:00 with the cover it already has."claude -p "Post this YouTube link to my Pinterest at noon."claude -p "Move the Pinterest post planned for Saturday to Sunday 11:00."
Pinterest rules to know
- A Pinterest video needs a cover picture, or schedule_post refuses it.
- With an imported link, the link's thumbnail becomes the cover; a link without one is refused for Pinterest.
- The pin title is the caption's first 100 characters and the description its first 800.
- The pin goes to the first board Pinterest lists; with no board, Kreatix creates one named Kreatix.
- Pinterest takes no text-only post, and get_stats has no numbers for it.
Tips for Claude Code
- --scope user makes Kreatix available in every project. Without it, the server is only added for the current project.
- claude -p can't ask for permission or open the sign-in. Sign in once with /mcp first, then allow the tools the run may use with --allowedTools, such as "mcp__kreatix__get_stats", or "mcp__kreatix__*" for all seven.
- Kreatix marks its reading tools (list_channels, list_groups, list_posts, get_stats) read-only, so Claude Code can run them in parallel, for example your stats and your queue at once.
- The agent checks the pages, caption and time with you before it posts. It cannot delete pages, read messages or change your account, and you can remove it any time in Settings > AI agent.
Questions
How do I post to Pinterest from Claude Code?
Connect Claude Code to Kreatix once, as shown above. Then ask it to post: name your Pinterest pages or a page group, the video or text and the time. Claude Code shows you the plan and posts after you say yes.
Why does my Pinterest video need a cover?
Pinterest refuses a video pin without one, and the refusal reads like a broken login. Kreatix asks for cover_url up front, or takes the thumbnail of a link it imports.
Which board does the pin go to?
The first board Pinterest lists for the account. If the account has no board, Kreatix creates one named Kreatix. The agent can't pick a board.
How long can the caption be?
Up to the tool's 5,000 characters, but Pinterest gets the first 100 as the title and the first 800 as the description.
Can my agent see how my pins perform?
No. get_stats measures Instagram, Facebook, TikTok and YouTube; Pinterest has no numbers in Kreatix.
I already added Kreatix on claude.ai. Do I add it again?
Not if Claude Code is logged in with the same claude.ai account (not an API key). Connectors from claude.ai show up in /mcp on their own.
How do I remove Kreatix completely?
Run claude mcp remove kreatix, then delete the key Claude Code used in Kreatix under Settings > AI agent. Removing the server in Claude Code doesn't revoke the key on Kreatix's side.
Kreatix schedules one video to every page you run, each with its own platform settings.
Start free, then connect Claude Code