Publish to WordPress from Hermes Agent

Hermes Agent can publish and schedule WordPress posts and pages through Postiz. Once the Postiz skill is installed, you send Hermes a draft or an outline from Telegram, Discord, Slack, or the CLI. It sets the title, uploads the featured image, chooses post or page, and schedules publishing on your connected WordPress site.

Setup Guide GitHub

Please make sure there is always a human in the loop.

Last updated: September 2026

Publish to WordPress in Seconds

Setup, then just ask

# One-time setup
npx skills add gitroomhq/postiz-agent
export POSTIZ_API_KEY=your_api_key

# Then just ask Hermes Agent:
> Publish this post on WordPress with
  a featured image, tomorrow at 9am

Hermes Agent: Done! Your WordPress post is scheduled.

WordPress-Specific Features

📝

Posts & Pages

Create both blog posts and static pages. Just say which one you want.

🖼

Featured Images

Upload and set featured images for your posts and pages. Eye-catching thumbnails drive more clicks from your site.

📄

Content Management

Manage your WordPress content by asking Hermes Agent. Create, schedule, and organize posts without touching the admin panel.

📅

Scheduled Publishing

Schedule posts and pages for future publication with precise timestamps. Plan your content calendar in advance.

🤖

AI-Powered Workflows

Let AI agents draft, format, and publish your WordPress content. From idea to published post without manual intervention.

🔄

Multi-Site Support

Connect multiple WordPress sites and publish to any of them. Manage all your sites from a single Postiz account.

How to publish to WordPress from Hermes Agent

You describe what you want in plain language and Hermes Agent handles the Postiz calls for you. Here is how a typical conversation goes.

Find Your WordPress Integration

Ask Hermes Agent whether your WordPress account is connected. It also checks which options the platform supports.

Example conversation

> Is my WordPress account connected to Postiz?

Hermes Agent: Yes — your WordPress account is connected
  and ready. Want me to post something?

Prepare Your Content

Write your content and optionally upload a featured image. WordPress supports HTML content for rich formatting.

Example conversation

> Draft a WordPress post about our new
  feature launch

Hermes Agent: Here's a draft for WordPress:
  "We just shipped something big..."
  Want me to add media and schedule it?

Create Your Post

Create a WordPress post or page with your content, title, featured image, and content type settings.

Example conversation

> Yes — add screenshot.png and schedule
  it for tomorrow at 9am

Hermes Agent: Done! Scheduled on WordPress for
  tomorrow at 9:00 AM.

WordPress Settings Reference

Mention any of these in plain language and Hermes Agent sets them for you. These are the WordPress options it can apply to any post.

Field	Type	Required	Description
`__type`	string	Yes	Must be "wordpress"
`title`	string	Yes	Post or page title (min 2 characters)
`main_image`	object	No	Featured image: {id: string, path: string}
`type`	string	Yes	Content type: "post" or "page"

Common Configurations

Ask Hermes Agent for any of these common WordPress publishing scenarios and it applies the matching settings.

Simple Blog Post

Just ask

> Post it with: Simple Blog Post

Hermes Agent: Got it. Applying:
  title: Getting Started with WordPress Automation
  type: post

Blog Post with Featured Image

Just ask

> Post it with: Blog Post with Featured Image

Hermes Agent: Got it. Applying:
  title: 10 Tips for Better Code Reviews
  main_image: id=img-abc123, path=https://uploads.postiz.com/code-reviews.jpg
  type: post

Static Page

Just ask

> Post it with: Static Page

Hermes Agent: Got it. Applying:
  title: About Our Company
  main_image: id=img-xyz789, path=https://uploads.postiz.com/about-hero.jpg
  type: page

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 such as the Postiz skill to post to WordPress and other channels. 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. Ask for a WordPress post from whichever app you already have open.

⏰

Built-in Cron Scheduler

Create recurring jobs in plain language, such as weekdays at 9am. Hermes drafts and schedules WordPress content through Postiz and reports back to your chat.

🔧

Open Source, Any Model

Hermes Agent is MIT licensed and self-hosted. Run it on Nous Portal, OpenRouter, OpenAI, or your own endpoint, and extend it with MCP servers or skills like Postiz.

How Postiz Works with Hermes Agent

Postiz ships as an agent skill in the agentskills.io SKILL.md format that Hermes Agent reads. The skill documents every Postiz CLI command, the credentials it needs, and the WordPress settings, so Hermes 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
✓Prefer MCP? Add https://mcp.postiz.com/mcp-oauth-dynamic under mcp_servers in ~/.hermes/config.yaml

Install Postiz

# Install the Postiz CLI and skill
npm install -g postiz
npx skills add gitroomhq/postiz-agent

# Authenticate: API key or OAuth device flow
export POSTIZ_API_KEY=your_api_key
# or: postiz auth:login

# Confirm Hermes can see the skill
hermes skills list

WordPress Publishing with Hermes Agent

Message Hermes Agent from any platform — it reads the Postiz skill, discovers your WordPress integration, and handles the entire publishing workflow autonomously.

🧠

From Any Chat App

Telegram, Discord, Slack, WhatsApp, Signal

Send a message to Hermes Agent from your favorite chat app. Its gateway runs in the background, so it picks up your message, discovers your WordPress site via Postiz, formats the post, and publishes it — all while you go about your day.

Hermes Agent

You: Post to WordPress about our new
  feature launch, schedule for tomorrow
  at 9am

Hermes: I'll handle that! Let me:
  1. Find your WordPress integration
  2. Compose your post content
  3. Schedule for tomorrow 9:00 AM

  Done! Post scheduled successfully.
  Post ID: abc-123

🧠

Scheduled & Proactive

Built-in Hermes cron jobs

Hermes Agent has a built-in cron scheduler. Create a recurring job in plain language and Hermes drafts and schedules your WordPress content through Postiz on that schedule, then reports back to whichever chat you use.

Hermes cron job

# From the terminal
hermes cron create "weekdays at 9am" \
  "Check ~/content/wordpress for new posts.
   Upload any media with postiz upload,
   then schedule each one to WordPress
   for noon today via Postiz. Move posted
   files to ~/content/published."

# Or from any chat with Hermes
/cron add "weekdays at 9am" "Schedule
  today's WordPress post via Postiz"

Why Hermes Agent + Postiz for WordPress

Hermes Agent makes Postiz a natural fit for your WordPress workflow. The agent discovers all available commands and autonomously chains them together.

✓Hermes Agent is MIT licensed and Postiz has a public API, so nothing is locked in
✓Chat-first: ask for a WordPress post from Telegram, Discord, Slack, WhatsApp, or Signal
✓Cron jobs in plain language for hands-free recurring WordPress posts
✓Cross-post to WordPress and other channels in one request, each with its own settings
✓Model-agnostic: run Hermes on Nous Portal, OpenRouter, OpenAI, or your own endpoint
✓Credentials stay in Postiz; Hermes only holds a Postiz API key or OAuth session

SKILL.md (what Hermes reads)

---
name: postiz
description: Postiz is a tool to schedule
  social media and chat posts to 28+
  channels including WordPress
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>

# WordPress settings
title, main_image, type

Using a different agent for WordPress?

Postiz works with any AI agent that can run CLI commands or call MCP tools, and the WordPress settings on this page are the same for every agent. Read the same guide for Claude Code, OpenClaw, Codex. Or see the guide for any AI agent and the Postiz MCP server.

WordPress + Other Platforms

Publish the same content to WordPress and other platforms in a single request. Each platform gets its own settings.

Example

> Post "Excited to announce our new feature!" to
  WordPress and LinkedIn tomorrow at 9am, then schedule
  a daily tip on WordPress every weekday at 10am

Hermes Agent: Done! Scheduled:
  - WordPress + LinkedIn: tomorrow 9:00 AM
  - Daily tips on WordPress: Mon-Fri 10:00 AM

What can you ask Hermes Agent to do on WordPress?

You can ask Hermes Agent to create, schedule, cancel, and measure WordPress posts in plain language. These are the kinds of requests it handles through Postiz.

Ask Hermes Agent

> Publish ~/posts/launch.md as a WordPress post with hero.png as the featured image, tomorrow at 9am.

Hermes uploads the image, sets title, type: post, and main_image, and schedules it.

Ask Hermes Agent

> Create a WordPress page titled "Integrations" from this outline and publish it now.

Hermes sets type: page and publishes immediately via Postiz.

Ask Hermes Agent

> What did I publish to WordPress in the last 30 days?

Hermes runs postiz posts:list filtered to the WordPress channel and summarizes.

WordPress rules Hermes Agent has to follow

Postiz validates every WordPress post before it is scheduled, so these limits and required settings decide whether a request succeeds.

▸type is required: post for blog posts, page for static pages. Say which one you want.
▸title must be at least 2 characters. The post content becomes the body and can include HTML.
▸The featured image must be uploaded through postiz upload and referenced by id and path in main_image.
▸Postiz publishes to the WordPress site you connected. Categories, tags, and custom fields are not set through these settings, so add them in WordPress afterwards.

Hermes Agent and WordPress: frequently asked questions

Can Hermes Agent publish to WordPress?

Yes. With the Postiz skill installed, Hermes Agent creates and schedules WordPress posts and pages with a title, body, and featured image on the site you connected to Postiz. You describe the content or point it at a file from any chat Hermes is connected to, and it runs the Postiz CLI commands.

How do I connect WordPress to Hermes Agent?

Connect your WordPress site in the Postiz dashboard, then install the Postiz skill in Hermes with npx skills add gitroomhq/postiz-agent and set POSTIZ_API_KEY. Hermes finds the WordPress channel with postiz integrations:list. Your WordPress credentials stay in Postiz; Hermes only holds the Postiz API key.

Can Hermes Agent create WordPress pages as well as posts?

Yes. The type setting accepts post or page. Ask for a page when you want static content such as an About or Integrations page, and a post for blog entries. Hermes sets the type from your wording, so say "page" explicitly if that is what you need.

How does Hermes Agent set a WordPress featured image?

Give Hermes the image and it uploads the file with postiz upload, then passes the returned id and path in the main_image setting. WordPress uses it as the featured image for the post or page. Images referenced by external URL or local path are rejected at publish time.

Can Hermes Agent publish to WordPress on a schedule?

Yes. Hermes Agent has a built-in cron scheduler. Run hermes cron create "every monday 9am" with a prompt such as "publish the newest markdown file in ~/posts/wordpress as a post via Postiz with the first image as featured". Hermes runs it unattended and confirms in your chat.