Hermes Agent + Pinterest

Pinterest posts with Hermes Agent and Bolta

Draft and review social posts from Telegram, Slack or your terminal. Parts of the Hermes Agent route are not confirmed yet, and the note below says which. Nothing goes live on Pinterest until you say yes.

Hermes uses the generic route: a server address plus a Bolta API key.

Hermes AgentBolta connected
You

Draft a Pinterest pin title under 100 characters and a description under 500 for the image I added, and show me both

Illustration of the reply: Bolta returns a draft showing the connected account and the scheduled time, with Approve, Edit and Reject actions.

Illustration. Your drafts show your real text, account and time.

What is and is not confirmed

Read this before you set up Hermes Agent

  • Confirmed from the Hermes docs: Hermes reads remote MCP servers from an mcp_servers block in ~/.hermes/config.yaml, with a url and a headers map for a Bearer key. Bolta's server is https://mcp.bolta.ai/mcp and takes a key that starts with bolta_sk_.
  • Not confirmed: we have not run this end to end in Hermes Agent. The OAuth option (auth: oauth) has never been tried against Bolta, so this page leads with the API key.
  • Not confirmed: the skill install command against Bolta's skills repo, and the exact tool names Hermes shows for Bolta (expected to start with mcp_bolta_). If a step differs on your machine, trust what Hermes shows you.
Bolta on Pinterest

What Bolta does on Pinterest

A pin needs an image or video, and it needs a board. If you do not choose one, Bolta uses the most recently synced board, and with no board connected the pin fails.

  • Pins with an image or video. One is required.
  • A pin title of up to 100 characters and a description of up to 500.
Limits and format

Pinterest limits and format rules

Bolta's posting rules for your workspace (get-posting-rules) win if they differ from this page.

Not promised for Pinterest from Hermes Agent: Idea Pins, video pins as a separate type, and Pinterest SEO tools. None is confirmed for Bolta. Pinterest analytics. This page makes no per-network analytics promise.

Pinterest limits and format rules
What to knowPinterest's own ruleWhat Bolta does
MediaNot stated on this page.An image or video is required for every pin.
BoardNot stated on this page.If you do not choose one, Bolta uses the most recently synced board. With no board connected the pin fails. No tool lists boards yet, so choose it on the pin in Bolta.
TitleNot stated on this page.Keep the pin title within 100 characters.
DescriptionNot stated on this page.Keep the pin description within 500 characters.
Best practices

Hermes Agent jobs for Pinterest, and how to write them

  • Have Hermes check the Bolta inbox each morning and tell you what is waiting, then approve only what you pick
  • Limit the Bolta tools Hermes sees to read and draft, so a self-hosted agent never has a publish tool in reach
  • Attach the image or video first. A pin cannot be approved without one.
Prompts

Example prompts for Pinterest

Things to type in Hermes Agent. Each one asks for a draft and shows you the text first.

Draft a Pinterest pin title under 100 characters and a description under 500 for the image I added, and show me both

Tell me which of my Bolta routines ran this week and whether any failed.

Tell me which board Bolta would use for my pin, and whether I should choose one in Bolta instead

Plan a launch campaign for next month from this brief, and show the plan before creating it.

Review

Bolta saves a draft, you read the exact text, you say yes

  1. 01

    Bolta saves a draft

    Hermes Agent asks Bolta for the Pinterest pin in your brand voice (save-post). A saved draft is never public.

  2. 02

    You read the exact text

    On Pinterest the exact text includes the title, the description, the image and the board it will land on.

  3. 03

    You say yes

    Only then does Bolta schedule or publish (publish-post), in your workspace's timezone. Safe Mode, client sign-off and brand approval rules still apply.

Hermes Agent and Bolta

Using Hermes Agent for Pinterest

Parts of this route are not confirmed. The note above says which.

For Pinterest, Hermes Agent, from Nous Research, reaches Bolta through Remote MCP server in ~/.hermes/config.yaml. Sign-in: API key (Bearer header). OAuth is untested. The Pinterest account itself is connected inside Bolta, not in Hermes Agent. Pinterest connects on the Team plan only for now, in beta.

Hermes Agent is open source and self-hosted, reached from chat apps or the terminal, and has a built-in scheduler. A weekly Pinterest drafting job is possible, with Bolta holding the approval step so nothing public goes out unreviewed.

This connection uses a Bolta API key, which acts as you. Safe Mode and client sign-off still apply to every Pinterest pin it saves, so keep them on.

An illustration from the Hermes Agent guide, not real output. You ask: Tell me which of my Bolta routines ran this week and whether any failed. The reply goes along these lines: I looked at your routines and their recent runs. I can summarise each one here. I will not change or restart anything unless you ask. Read only. Nothing changed.

No. The MCP connection is what lets Hermes call Bolta. The skill is a folder of instructions that teaches Hermes how Bolta works, such as checking posting rules before saving a draft. Hermes installs skills with hermes skills install owner/repo/path, and Bolta's skill is in the boltaai/bolta-skills repo under skills/bolta.

Set who may message your Hermes bot in Hermes before you add a Bolta key.

Create a Bolta key with only the permissions you need. A drafting key does not need to publish.

  • Campaigns and planning. For a launch or a themed month, Hermes can build a campaign plan from your brief and revise it before anything is created.
  • Voice and brand. Bolta holds the voice profile and the business DNA, so a draft requested from any chat app comes out the same way. Hermes memory can hold working notes on top.
  • Hermes finds your workspace and accounts. Before drafting, Hermes asks Bolta which workspaces and brands this key can reach, so a post is never aimed at a brand you did not name.
  • It reads how you sound. Hermes keeps its own memory across sessions, but the voice that matters for drafts is the one stored in Bolta, so it reads that before writing.
  • Setup: Check the connection. In a Hermes chat type /reload-mcp, or in a terminal run hermes mcp test bolta. You should see Bolta's tools listed. The Hermes docs name MCP tools with an mcp_ prefix and the server name, so expect names like mcp_bolta_save_post.
  • Setup: Run a read-only test. Ask Hermes: "List my Bolta workspaces and accounts." Check that it names the right brands. If none are connected, ask it for a Bolta connect link and add an account first.
  • Plugin or extension. Bolta's plugin is built for Claude Code. Hermes has no matching plugin from Bolta, so use the MCP entry.
  • A Hermes cron job fires only while your Hermes install is running, for example on a server or a machine you leave on. If the machine sleeps, the job does not run.
  • Hermes cron. Choose this if you want the result delivered into a chat app. Hermes has its own scheduler that runs unattended and reports back to you. It only fires while your Hermes install is running, so it suits a machine or server you leave on. Drafts still land in Bolta review.
Connect

Connect Hermes Agent to Bolta

Hermes uses the generic route: a server address plus a Bolta API key.

FAQ

Pinterest questions, answered for Hermes Agent

Which board does Hermes Agent pin to on Pinterest?
If you do not choose a board, Bolta uses the most recently synced one, and with no board connected the pin fails. No tool lists boards yet, so choose the board on the pin in Bolta.
Do I need a particular Bolta plan to post to Pinterest from Hermes Agent?
Pinterest connects on the Team plan only for now, in beta. The connection is made in Bolta, not in the AI tool.
One connection covers which brands?
A Bolta API key belongs to one organization, so it reaches the brands in that organization. Ask Hermes to list your workspaces first, and name the brand when you ask for a draft.
How do I limit which Bolta tools Hermes can call?
The Hermes docs describe tools.include and tools.exclude settings for a server, and hermes mcp configure bolta opens a checklist. Leave read and draft tools on and the approve and publish tools off. We have not tested these settings with Bolta.
What do I do if Hermes says the server is unreachable?
Check the url is exactly https://mcp.bolta.ai/mcp, check the indentation under mcp_servers, then run hermes mcp test bolta. If the test passes but chat still has no Bolta tools, type /reload-mcp.
hermes mcp test bolta says the server is unreachable.
Check the url is exactly https://mcp.bolta.ai/mcp with no trailing text, and that the machine running Hermes can reach the internet. A YAML indentation slip under mcp_servers is a common cause, so check the spacing of that block first.
Does Hermes Agent publish Pinterest pins without my yes?
No. Nothing is approved, scheduled or published until you say yes to that Pinterest pin. Whether Hermes Agent completes the connection is not fully confirmed, so read the note above first.

More from Hermes Agent

Hermes Agent can work with the other networks Bolta publishes to. Each page has its own limits and review notes.

Pinterest from other AI agents

The same Pinterest limits apply whichever agent asks. The connection and the setup are what change.

Try a Pinterest draft from Hermes Agent

Connect Hermes Agent, ask for a Pinterest draft and read the exact text. Nothing goes live until you say yes.