AI agent guides / Hermes Agent

Hermes Agent by Nous Research

How to post to social media from Hermes Agent

Hermes Agent picks up MCP servers from one config file. Add Hey Tasky and it can write and schedule posts across your connected accounts, and you can limit it to drafts if you'd rather approve everything.

Updated October 14, 2026

Setup

Connect Hermes Agent in 3 steps

You need a Hey Tasky workspace with at least one social account connected. Connect X, LinkedIn, Bluesky, Mastodon, or another network in Hey Tasky first, so Hermes Agent has somewhere to post.

  1. Add the Hey Tasky server

    Run this, or add the same entry under mcp_servers in ~/.hermes/config.yaml.

    hermes mcp add --url https://mcp.heytasky.com/mcp --auth oauth heytasky
  2. Sign in to Hey Tasky

    Run the login command and approve access in the browser. On a server with no browser, Hermes offers a device code you enter on another device.

    hermes mcp login
  3. Reload and test

    In a running session, type /reload-mcp, then ask Hermes which Hey Tasky accounts it can post to.

Try it

Things to ask Hermes Agent

  • "Draft a thread about what I shipped this week and save it to Hey Tasky as a draft."
  • "Find my best posting times in Hey Tasky and schedule these three posts into them."
  • "Summarize the replies on my last five posts."
Capabilities

What Hermes Agent can do in Hey Tasky

These are the tools Hey Tasky's MCP server gives Hermes Agent. Ask for a draft when you want to read a post before it goes out; a scheduled post publishes on its own at the time you set.

list_channels
Lists the accounts connected to your workspace, with the ids the agent needs to target them.
list_social_sets
Lists your social sets, such as one brand across X and Threads, so you can say "post this to my text list".
create_post
Saves a draft you review and schedule later in Hey Tasky. Nothing is published.
schedule_post
Schedules a post to one or more channels at an exact time. Hey Tasky publishes it automatically.
get_queue
Reads what is scheduled, published, or failed.
get_post_results
Returns impressions, likes, replies, reposts, and quotes for published posts, where the network reports them.
list_replies
Pulls replies to your posts, sorted into leads, questions, and praise.
get_best_times
Suggests weekday and hour slots from how your posts performed over the last 90 days.
get_account
Confirms which workspace and timezone the agent is working in.
Good to know

Before you rely on it

  • Ask for drafts until you trust the setup. A draft waits in Hey Tasky for you; a scheduled post publishes on its own at the time you set.
  • Want Hermes to draft but never publish? Add a tools exclude list for schedule_post on the heytasky server in config.yaml.
  • Prefer a key? Replace auth: oauth with a headers entry, Authorization: "Bearer ${HEYTASKY_API_KEY}". Create an API key in Hey Tasky under Settings, Developers. Treat it like a password: anyone with the key can post to your workspace.
FAQ

Hermes Agent and Hey Tasky questions

Where does Hermes store the Hey Tasky sign-in?

Under ~/.hermes/mcp-tokens/ on the machine running Hermes. Revoke access from Hey Tasky at any time.

Can I keep Hermes to drafts only?

Yes. Exclude schedule_post in the server's tools filter and Hermes can only save drafts for you to schedule.

Does Hermes need to stay running for scheduled posts?

No. Hey Tasky publishes scheduled posts itself, at the time you set.