Hermes Agent + PostizSchedule Social Media Posts with Hermes Agent
- Install the Postiz skill once, then just ask Hermes
- Post from Telegram, Discord, Slack, WhatsApp or the CLI
- Draft, schedule, cross-post and measure on 30+ platforms
How do I set up Postiz in Hermes Agent?
Setup takes four commands: install Hermes Agent, install the Postiz CLI, add the Postiz skill, and authenticate. After that you just ask. The step-by-step install guide covers Windows, OAuth login, and troubleshooting.
Run this in your terminal
Install Hermes Agent, then the Postiz CLI and skill. Hermes loads the SKILL.md from ~/.hermes/skills.
# One-time setup
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
hermes setup
npm install -g postiz
npx skills add gitroomhq/postiz-agent
export POSTIZ_API_KEY=your_api_key # or: postiz auth:loginPrefer OAuth over an API key? Add the Postiz MCP server to ~/.hermes/config.yaml instead; the config is shown below. Run hermes skills list to confirm Hermes sees the skill.
Ask Hermes to post for you
From the CLI, Telegram, Discord, Slack, WhatsApp or Signal. Hermes runs the Postiz commands and reports back.
Post "Hello from Postiz!" to X and LinkedIn, schedule it for tomorrow at 9am
Ran postiz integrations:list and found your X and LinkedIn channels. Created the post with posts:create, scheduled for tomorrow at 9:00 AM on both. Want it as a draft next time?
via Postiz
Also try
- 1Install Hermes Agent with the official install script, then run hermes setup
- 2Install the Postiz CLI (npm install -g postiz) and add the skill with npx skills add gitroomhq/postiz-agent
- 3Set POSTIZ_API_KEY from your Postiz settings, or run postiz auth:login for an OAuth device flow
- 4Message Hermes from the CLI, Telegram, Discord or Slack and ask it to post
One skill install powers every channel Hermes runs
Connect your accounts in Postiz once. From then on Hermes can post to any of them from whichever chat you have open, and Postiz publishes at the time you set.
Postiz skill or Postiz MCP server: which should Hermes Agent use?
Hermes Agent can reach Postiz two ways, and both give you the same channels and scheduling. The skill runs the Postiz CLI in Hermes's terminal tool; the Postiz MCP server plugs into Hermes's native MCP support with OAuth.
| Postiz skill (CLI) | Postiz MCP server | |
|---|---|---|
| Install | npm install -g postiz, then npx skills add gitroomhq/postiz-agent. Hermes loads the SKILL.md from ~/.hermes/skills. | Add https://mcp.postiz.com/mcp-oauth-dynamic under mcp_servers in ~/.hermes/config.yaml with auth: oauth. |
| Authentication | POSTIZ_API_KEY from your Postiz settings, or postiz auth:login for an OAuth device flow. | OAuth login in the browser on first use. No API key to copy or store. |
| How Hermes calls it | Runs postiz CLI commands in its terminal tool. Every command returns JSON. | Calls MCP tools named mcp_postiz_<tool>, the same way it uses any other MCP server. |
| Media | postiz upload <file> returns a verified URL that posts:create accepts. | Upload tools plus AI image and video generation and YouTube clipping tools. |
| Best for | Cron jobs, headless servers, and anywhere Hermes has shell access. | Teams that prefer OAuth over API keys, or already run Hermes with other MCP servers. |
mcp_servers:
postiz:
url: "https://mcp.postiz.com/mcp-oauth-dynamic"
auth: oauth
# Hermes exposes the tools as mcp_postiz_<tool>
# and opens a browser for the OAuth login once.What can Hermes Agent do with Postiz?
Hermes Agent can do everything the Postiz CLI can: discover channels, upload media, create threads, apply platform settings, schedule campaigns, and read analytics.
AI Agent Ready
Postiz returns structured JSON, so Hermes Agent can plan, run, and verify multi-step social media workflows on its own.
30+ Platforms
Post to X, LinkedIn, Reddit, Instagram, YouTube, TikTok, Threads, Bluesky, Mastodon, and more. One request from you, Hermes Agent handles every platform.
Threads & Comments
Create threaded posts with multiple comments, each with their own media. Automatic conversion to platform-native threads.
Rich Media Support
Upload and attach images, videos, audio, and documents. Supports PNG, JPG, MP4, MOV, PDF, and many more formats.
Scheduled Posting
Schedule posts with precise timestamps, create drafts for review, and batch schedule entire content campaigns.
Platform-Specific Settings
Dynamic discovery of platform features like Reddit flairs, YouTube playlists, Pinterest boards, and LinkedIn company pages.
How does Hermes Agent post to social media?
You describe what you want in plain language and Hermes Agent chains the Postiz commands: list channels, upload media, create the post, then confirm. Here is how a typical conversation goes.
- 1
Discover Integrations
List all your connected social media accounts and discover platform-specific features like subreddit flairs and YouTube playlists.Example conversation> What social accounts do I have connected? Hermes Agent: You have 4 channels connected: X, LinkedIn, Reddit, and YouTube. I can also check platform options like subreddit flairs or YouTube playlists. - 2
Create Posts
Describe the post: content, media, comments, and any platform options. Hermes Agent uploads the media through Postiz and builds the post, from a quick one-liner to a full campaign.Example conversation> Post "Check out our new feature!" with screenshot.png to X and LinkedIn, tomorrow at 9am Hermes Agent: Done! Scheduled on X and LinkedIn for tomorrow at 9:00 AM with the image. - 3
Manage & Analyze
List, filter, and manage your scheduled posts. Track performance with platform and post-level analytics. Ask for a week of content and Hermes Agent schedules the whole campaign.Example conversation> What's scheduled this week, and how did last month's posts perform? Hermes Agent: 5 posts scheduled Mon-Fri. Here are last month's impressions and engagement per channel, with your best-performing post highlighted.
One Request, Every Platform
Ask once and Hermes Agent posts to every platform at the same time, each with its own media and settings. For example:
> Post "Launching our new feature today!" with
banner.png to X, LinkedIn, and Facebook tomorrow
at 9am. On Reddit, post it to r/programming as a
text post titled "New Tutorial". Then schedule a
daily tip on X and LinkedIn for the rest of the week.
Hermes Agent: Done! Here's what I scheduled:
- X, LinkedIn, Facebook: tomorrow 9:00 AM (banner.png)
- Reddit r/programming: tomorrow 9:00 AM, "New Tutorial"
- Daily tips: Mon-Fri 9:00 AM on X and LinkedInCan Hermes Agent post on a schedule without me?
Yes. Hermes Agent ships with a cron scheduler that takes plain language or cron expressions, runs the job unattended, and delivers the result to Telegram, Discord, Slack, email, or all of them. Combined with Postiz drafts, you can keep a human approval step in the loop.
Chat Workflow
Telegram, Discord, Slack, WhatsApp, Signal, CLI
Message Hermes from whichever app you already have open. It connects to Postiz, discovers your accounts, uploads media, and schedules the posts while you carry on with your day.
You: Post my blog article to X, LinkedIn,
and Reddit with the cover image,
schedule for tomorrow at 9am
Hermes: On it.
1. Found your integrations via Postiz
2. Uploaded cover image
3. Scheduled across 3 platforms
Done! Posts scheduled:
- X: 9:00 AM
- LinkedIn: 9:00 AM
- Reddit (r/programming): 9:00 AMScheduled Workflows
Built-in Hermes cron jobs
Create a recurring job from the terminal or from chat. Hermes runs it on schedule, drafts and publishes through Postiz, and reports back. Jobs are stored in ~/.hermes/cron/jobs.json.
# From the terminal
hermes cron create "weekdays at 8am" \
"Check ~/content/drafts for new posts.
Upload any media with postiz upload,
schedule each one to all my channels
for noon today, then move the files
to ~/content/published."
# Or from any chat with Hermes
/cron add "every monday 9am" "Draft this
week's LinkedIn post as a Postiz draft
and send it to me for approval"What is Hermes Agent?
Hermes Agent is an open-source AI agent from Nous Research, released under the MIT license. It runs on your own machine or server, you talk to it from Telegram, Discord, Slack, WhatsApp, Signal, or the CLI, and it executes tools and skills on your behalf, including the Postiz skill for social media. It works with Nous Portal, OpenRouter, OpenAI, or your own model endpoint.
Message From Anywhere
Talk to Hermes from Telegram, Discord, Slack, WhatsApp, Signal, email, or the terminal. Start the gateway with hermes gateway setup and hermes gateway start.
Skills, Memory, and MCP
Skills follow the agentskills.io SKILL.md standard and live in ~/.hermes/skills. Hermes also keeps agent-curated memory and can connect to any MCP server.
Open Source, Any Model
MIT licensed and self-hosted, with local, Docker, SSH, Modal, and other sandbox backends. Switch models with hermes model without changing your setup.
How Postiz Becomes a Hermes Skill
Postiz ships as an agent skill: a SKILL.md file that documents every Postiz CLI command, the credentials it needs, and the rules for each platform. Hermes reads it and knows how to list your channels, upload media, and create posts without any custom code.
- Install the Postiz CLI (npm install -g postiz) and add the skill with npx skills add gitroomhq/postiz-agent
- Hermes loads skills from ~/.hermes/skills and shows them with hermes skills list
- Authenticate with POSTIZ_API_KEY, or run postiz auth:login for an OAuth device flow
- Every Postiz command returns JSON, so Hermes can chain discovery, upload, and posting
- Self-hosting Postiz? Point the CLI at your server with POSTIZ_API_URL
---
name: postiz
description: Postiz is a tool to schedule
social media and chat posts to 28+
channels X, LinkedIn, Reddit, Instagram,
Facebook, Threads, YouTube, TikTok, ...
homepage: https://docs.postiz.com/public-api/introduction
---
# Commands Hermes can run
postiz auth:status
postiz integrations:list
postiz integrations:settings <id>
postiz upload <file>
postiz posts:create -i <id> -c "..." -s <iso>
postiz posts:list
postiz analytics:platform <id>What can you ask Hermes Agent to do?
You can ask Hermes Agent anything the Postiz CLI can do. A few examples, and what happens behind the scenes:
Ship a launch post
Post "Launching our new feature today!" with banner.png to X, LinkedIn, and Facebook tomorrow at 9am.
Post to a subreddit with the right flair
What flairs are available in r/programming? Then post it there as a text post titled "New Tutorial".
Schedule a week of tips
Schedule a daily tip on X and LinkedIn for the rest of the week at 9am. Save them as drafts so I can review first.
Check the calendar and the numbers
What's scheduled for this week, and how did my X and YouTube accounts do last month?
Which platforms can Hermes Agent post to?
Hermes Agent can post to every channel Postiz supports, 30+ in total. These 25 have a dedicated guide with example prompts, the exact settings Hermes can apply, and platform rules such as character limits and required fields.
Post to X (Twitter) from Hermes Agent
Tweets, threads, and reply controls
Post to LinkedIn from Hermes Agent
Professional posts and image carousels
Post to Instagram from Hermes Agent
Feed posts, stories, and reels
Post to Facebook from Hermes Agent
Text posts, links, and media
Post to Reddit from Hermes Agent
Subreddits, flairs, and post types
Post to YouTube from Hermes Agent
Video uploads, thumbnails, and tags
Post to TikTok from Hermes Agent
Videos, privacy, duets, and stitches
Post to Pinterest from Hermes Agent
Pins, boards, and link pins
Post to Discord from Hermes Agent
Channel messaging and media
Post to Slack from Hermes Agent
Channel messaging and team updates
Post to Telegram from Hermes Agent
Bot-powered channel messaging
Post to Twitch from Hermes Agent
Chat messages and announcements
Post to Kick from Hermes Agent
Chat messages and notifications
Post to Medium from Hermes Agent
Articles, publications, and tags
Post to Dev.to from Hermes Agent
Developer articles and organizations
Post to Hashnode from Hermes Agent
Blog posts and publications
Post to WordPress from Hermes Agent
Posts, pages, and featured images
Post to Dribbble from Hermes Agent
Design shots and team portfolios
Post to Warpcast from Hermes Agent
Farcaster casts and channels
Post to Lemmy from Hermes Agent
Federated community posts
Post to Moltbook from Hermes Agent
AI agent social network
Post to Google My Business from Hermes Agent
Business posts, events, and offers
Post to Listmonk from Hermes Agent
Email campaigns and newsletters
Post to Skool from Hermes Agent
Community posts and groups
Post to Whop from Hermes Agent
Company forums and experiences
Hermes Agent and Postiz: frequently asked questions
What is Hermes Agent?
Is Hermes Agent the same as the Hermes language models?
Is Hermes Agent the same as OpenClaw?
How do I install Postiz in Hermes Agent?
Should I use the Postiz skill or the Postiz MCP server with Hermes Agent?
Which social media platforms can Hermes Agent post to?
Can Hermes Agent post to social media on a schedule without me?
Does Hermes Agent need my social media passwords?
Is using Hermes Agent with Postiz free?
What should I check when a Hermes Agent post fails in Postiz?
Using a different AI agent?
Postiz works with any agent that can run CLI commands or call MCP tools. The same skill powers Claude Code, OpenClaw, Codex, and any other AI agent. MCP clients can connect through the Postiz MCP server.
Start automating today
Set up Postiz once and let Hermes Agent handle your social media posting across every platform. You just ask.