Post to Pinterest from Codex
Codex is OpenAI's coding agent. It runs as the Codex CLI in your terminal, as an IDE extension and inside the ChatGPT desktop app, and all three can use MCP servers. A video pin with a cover picture, on one of your boards.
Connect Codex 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: codex mcp add kreatix --url https://api.kreatix.cc/mcp
- Run codex mcp login kreatix, sign in to Kreatix in the browser and press Allow.
- Start codex and type /mcp to check that kreatix is listed.
codex mcp add kreatix --url 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.
- Add the [mcp_servers.kreatix] table from the snippet to the end of ~/.codex/config.toml.
- To keep the key out of the file instead, run export KREATIX_API_KEY=YOUR_KEY in your shell and then codex mcp add kreatix --url https://api.kreatix.cc/mcp --bearer-token-env-var KREATIX_API_KEY.
- Check with codex mcp list, or with /mcp inside codex.
[mcp_servers.kreatix]
url = "https://api.kreatix.cc/mcp"
http_headers = { "Authorization" = "Bearer YOUR_KEY" }What Codex 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 the codex terminal app, or one-off from a script: codex exec "Which of my Kreatix pages got the most views this week?"
codex exec "Pin my newest video to Pinterest tomorrow at 20:00 with the cover it already has."codex exec "Post this YouTube link to my Pinterest at noon."codex exec "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 Codex
- Add default_tools_approval_mode = "writes" to [mcp_servers.kreatix]. Codex then asks before schedule_post, reschedule_post and cancel_post, and runs the reading tools straight away.
- Set it up once: the Codex CLI, the IDE extension and Codex in the ChatGPT desktop app share ~/.codex/config.toml.
- In the IDE extension you can skip the terminal: gear menu > MCP servers > Add server, choose Streamable HTTP, enter the address, save, select Restart extension, then Authenticate.
- 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 Codex?
Connect Codex 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. Codex 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.
Can I sign in on a machine without a browser?
Yes. Run codex mcp login kreatix --no-browser, open the printed link on another device, sign in and press Allow, then paste the full redirect URL back into the terminal.
Does the config go in my home folder or the project?
~/.codex/config.toml works everywhere. A project's .codex/config.toml also works, but only in projects you trust.
Kreatix schedules one video to every page you run, each with its own platform settings.
Start free, then connect Codex