Skip to content

Schedule social media posts with Hermes Agent

Add Postelk to Hermes Agent, Nous Research’s open-source agent, with a short entry in its config file. Once signed in, Hermes can schedule and publish posts from wherever it runs.

  • A few lines in config.yaml
  • One command to sign in
  • Runs on your own machine or server

Needs a paid Postelk plan. Setup steps last checked against Nous Research’s documentation on November 7, 2026.

Setup

How do I connect Postelk to Hermes Agent?

Hermes reads MCP servers from ~/.hermes/config.yaml and handles the OAuth sign-in by itself.

1Connectabout a minute

Add Postelk to Hermes Agent

  1. Open ~/.hermes/config.yaml and add the block below under mcp_servers.
  2. Run hermes mcp login postelk and finish the Postelk sign-in in your browser.
  3. Restart Hermes and ask it to list your connected accounts.
config.yaml
mcp_servers:
  postelk:
    url: https://mcp.postelk.com/mcp
    auth: oauth

Hermes identifies itself to Postelk automatically (client metadata or dynamic registration), so there is nothing else to configure. If Hermes runs on a server without a browser, use hermes mcp login postelk --flow device.

Menus change. If yours looks different, follow Hermes Agent’s MCP documentation.

2Delegateruns in Postelk

Then hand Hermes Agent the job

Once connected, Hermes Agent can use the Postelk tools as one part of a longer task. Whatever it schedules is published by Postelk’s servers at the set time, whether or not the agent is still running.

What it can do

What can Hermes Agent do with Postelk?

Hermes Agent can plan, schedule and publish posts as part of a larger task, then check the results, all through the Postelk tools it discovers when you connect.

Hand over the whole job

Give Hermes Agent the brief and the media links. It writes the text for each platform and schedules every post through Postelk.

A week in one request

Up to 60 posts can be queued at once, each with its own accounts, text and time.

Fix what went wrong

Hermes Agent can see which posts went out and which failed, read the reason Postelk gives and retry the ones worth retrying.

Report back

Ask for last week’s views, likes and comments per account and let Hermes Agent tell you what to repeat.

Network settings

A YouTube title and visibility, TikTok’s comment, Duet and Stitch switches or who can reply on Threads travel in the same request.

Your default settings

The post settings you saved in Postelk apply to every post Hermes Agent creates, unless the request sets something else.

Jobs

Jobs you can hand to Hermes Agent

Describe the outcome, not the clicks. Hermes Agent works through the Postelk tools and leaves everything on your calendar.

Drafts

Drafts for approval

Prepare next week’s posts from the campaign notes and save them as drafts. I will review them in Postelk.

Calendar

Find the gaps

Look at what is scheduled for next week and tell me which days have no post.

Fix

Swap the video

The Wednesday post has the wrong video. Replace it with the newest file in my library and keep the time.

Monthly

Write the monthly report

Write a short report for the last 30 days: totals per account and the three posts with the most views.

Hermes Agent and Postelk: frequently asked questions

How do I add Postelk to Hermes Agent?

Open ~/.hermes/config.yaml and add the Postelk block from the setup steps above under mcp_servers. Run hermes mcp login postelk and finish the Postelk sign-in in your browser. Restart Hermes and ask it to list your connected accounts. The Postelk MCP link is https://mcp.postelk.com/mcp.

Do I need a paid Hermes Agent plan?

Hermes Agent is open source and runs on your own machine or server; Nous Research lists no plan requirement.

What if Hermes runs on a server without a browser?

Hermes identifies itself to Postelk automatically (client metadata or dynamic registration), so there is nothing else to configure. If Hermes runs on a server without a browser, use hermes mcp login postelk --flow device.

How do I see what Hermes Agent scheduled?

Open your Postelk calendar. Every post Hermes Agent creates appears there with its accounts and time, and you can edit, move or cancel it before it goes out.

What can Hermes Agent change after a post is scheduled?

Until a post goes out, Hermes Agent can change its accounts, text, media and time, or cancel it. A post that is already published cannot be edited or cancelled through Postelk.

Does Hermes Agent need my social media passwords?

No. You connect your social accounts inside Postelk, through each platform’s own sign-in. Hermes Agent only talks to Postelk, with the access you approve.

Is this included in my Postelk plan?

Yes. The MCP server and the REST API are included in every paid Postelk plan. The same daily limits and checks apply as in the app.

Hermes Agent does not show the Postelk tools. What should I check?

Check that the server URL is exactly https://mcp.postelk.com/mcp, that you finished the Postelk sign-in, and that you approved access with the account that has your connected channels. Removing the connection and adding it again fixes most cases.

Plan the week. Fill every feed.

Schedule posts to every connected account from one calendar. Start with a 7-day free trial.

Start your free trial →