Skip to main content
Hermes Agent is Nous Research’s open-source agent with persistent memory, skills, scheduled jobs and gateways to Telegram, Discord, Slack, WhatsApp, Signal, email and more. You run it on your own computer or a server, or hosted in Hermes Cloud. Add PostQueen as an MCP server and Hermes can plan your posts, schedule them and report how they did, in a chat or on a schedule.
A sample Hermes Agent chat on a phone with PostQueen connected: a request for posts, the PostQueen tools it used, and the reply

​
Before you start

  • Plans: Hermes Agent is free and open source (MIT). Nous Research also offers the Nous Portal subscription and hosted instances in Hermes Cloud.
  • Platforms: wherever you run Hermes: macOS (Apple Silicon), Windows 10 and 11, Linux and WSL2, or Docker. The installer brings Python 3.11 and Node.
  • A PostQueen API key. A workspace admin copies it, or the ready-made address, from Connections.
Where the API key is: in the app, open Connections > API Keys. Only a workspace Admin or Super Admin can reveal or rotate it; other members see it masked. A workspace has one key, and each agent card on Connections shows your MCP address with the key already filled in.

​
Connect Hermes Agent

1

Add PostQueen to the config

Add this block to ~/.hermes/config.yaml, with your key in place of YOUR_API_KEY:
~/.hermes/config.yaml
2

Load the tools

Start a new hermes chat, or type /reload-mcp in a running session.
3

Test the connection

​
Check that it works

Ask Hermes: “List my PostQueen channels.” It calls PostQueen and answers with the channels you connected.

​
Good to know

  • PostQueen is not in hermes mcp catalog. The catalog, and the setup card you get by asking in chat, cover only servers Nous has approved. Add PostQueen in config.yaml or with hermes mcp add.
  • Hermes can edit the config for you if you allow it, then run /reload-mcp.
  • Recurring jobs live in hermes cron, not in config.yaml. See Run it on a schedule.
  • Ask for drafts when you want to check first. A draft waits on your PostQueen calendar, and nothing publishes until you schedule it.
  • What it cannot do over MCP: delete a post, or change a post’s text or time. Do that on the calendar in the app. The MCP tools lists what it can do.

​
Other ways to connect

To keep the key out of config.yaml, add the server with a command and paste the key when Hermes asks:
Hermes keeps the key in its own secrets file as MCP_POSTQUEEN_API_KEY and sends it as a Bearer token.

​
Try this first

The drafts appear on your PostQueen calendar, ready for you to check and schedule. Prompts to try has more.

​
Run it on a schedule

Ask Hermes in chat, or run hermes cron create. Each job runs in a fresh session and can send its result to Telegram, Discord, Slack or email.
Source: Nous Research, scheduled tasks.

​
Troubleshooting

More fixes are on Troubleshooting agents. To message Hermes from WhatsApp, Telegram, Slack or Discord, see Chat channels.

​
Next steps

Every agent

Which agents can post to PostQueen, and how each one connects.

The MCP tools

What each of the 22 tools does, and what an agent cannot do.

Prompts and tool calls

The order an agent calls the tools in, with prompts that work.

Troubleshooting agents

What to do when a connection or a command fails.
Last modified on September 24, 2026