Post to TikTok from Hermes Agent

Hermes Agent can publish and schedule TikTok videos through Postiz. Once the Postiz skill is installed, you send Hermes a video and caption from Telegram, Discord, WhatsApp, or the CLI. It uploads the file, sets the privacy level, duet, stitch, and comment permissions, adds any branded or AI-content disclosure, and posts directly to your account.

Setup Guide GitHub

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

Last updated: September 2026

Post to TikTok 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:
> Post clip.mp4 to TikTok as public
  with a caption, tomorrow at 6pm

Hermes Agent: Done! Your TikTok post is scheduled.

TikTok-Specific Features

🔒

Privacy Controls

Set video visibility to public, friends only, followers only, or private. Control exactly who sees each post.

🎬

Duets & Stitches

Enable or disable duets and stitches per video. Let your audience remix your content or keep it locked down.

🎵

Auto Music

Automatically add background music to your videos with the autoAddMusic setting. Perfect for quick clips.

📢

Branded Content

Toggle branded content and organic branded content disclosures to stay compliant with TikTok's policies.

🤖

AI Disclosure

Mark videos as AI-generated to comply with TikTok's transparency requirements for AI-created content.

📅

Scheduled Posting

Schedule videos with precise timestamps. Use DIRECT_POST for immediate publishing or UPLOAD for draft mode.

How to post to TikTok 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 TikTok Integration

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

Example conversation

> Is my TikTok account connected to Postiz?

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

Upload Your Video

Upload your video file to get a public URL. TikTok requires media to be accessible via HTTPS. Supports MP4, MOV, AVI, MKV, WEBM, and more.

Example conversation

> Draft a TikTok post about our new
  feature launch

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

Create Your Post

Schedule a TikTok post with your video, caption, hashtags, and platform-specific settings like privacy level, duet/stitch permissions, and content disclosures.

Example conversation

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

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

TikTok Settings Reference

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

Field	Type	Required	Description
`privacy_level`	string	Yes	Who can view: PUBLIC_TO_EVERYONE, MUTUAL_FOLLOW_FRIENDS, FOLLOWER_OF_CREATOR, SELF_ONLY
`title`	string	No	Video title (max 90 characters)
`duet`	boolean	Yes	Allow duets on this video
`stitch`	boolean	Yes	Allow stitches on this video
`comment`	boolean	Yes	Allow comments on this video
`autoAddMusic`	string	Yes	Auto-add music: yes or no
`brand_content_toggle`	boolean	Yes	Branded content disclosure
`brand_organic_toggle`	boolean	Yes	Organic branded content
`video_made_with_ai`	boolean	No	AI-generated content disclosure
`content_posting_method`	string	Yes	DIRECT_POST or UPLOAD (draft)

Common Configurations

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

Public Video with Full Interactions

Just ask

> Post it with: Public Video with Full Interactions

Hermes Agent: Got it. Applying:
  privacy_level: PUBLIC_TO_EVERYONE
  title: My Awesome Video
  duet: yes
  stitch: yes
  comment: yes
  autoAddMusic: no
  brand_content_toggle: no
  brand_organic_toggle: no
  video_made_with_ai: no
  content_posting_method: DIRECT_POST

Branded Content Post

Just ask

> Post it with: Branded Content Post

Hermes Agent: Got it. Applying:
  privacy_level: PUBLIC_TO_EVERYONE
  title: Partnership with Brand
  duet: no
  stitch: no
  comment: yes
  autoAddMusic: no
  brand_content_toggle: yes
  brand_organic_toggle: yes
  video_made_with_ai: no
  content_posting_method: DIRECT_POST

AI-Generated Content

Just ask

> Post it with: AI-Generated Content

Hermes Agent: Got it. Applying:
  privacy_level: PUBLIC_TO_EVERYONE
  title: AI Generated Art
  duet: yes
  stitch: yes
  comment: yes
  autoAddMusic: yes
  brand_content_toggle: no
  brand_organic_toggle: no
  video_made_with_ai: yes
  content_posting_method: DIRECT_POST

Private Draft (Upload Only)

Just ask

> Post it with: Private Draft (Upload Only)

Hermes Agent: Got it. Applying:
  privacy_level: SELF_ONLY
  duet: no
  stitch: no
  comment: no
  autoAddMusic: no
  brand_content_toggle: no
  brand_organic_toggle: no
  content_posting_method: UPLOAD

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 TikTok 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 TikTok 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 TikTok 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 TikTok 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

TikTok Posting with Hermes Agent

Hermes Agent reads Postiz commands through its tool system, discovers your integrations, and handles the entire posting workflow — from content creation to scheduling.

🧠

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 TikTok account via Postiz, uploads the video, and schedules the post — all while you go about your day.

Hermes Agent

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

Hermes: I'll handle that! Let me:
  1. Find your TikTok 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 TikTok 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/tiktok for new posts.
   Upload any media with postiz upload,
   then schedule each one to TikTok
   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 TikTok post via Postiz"

Why Hermes Agent + Postiz for TikTok

Hermes Agent makes Postiz a natural fit for your TikTok 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 TikTok post from Telegram, Discord, Slack, WhatsApp, or Signal
✓Cron jobs in plain language for hands-free recurring TikTok posts
✓Cross-post to TikTok 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 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>

# TikTok settings
privacy_level, title, duet, stitch, comment, autoAddMusic, brand_content_toggle, brand_organic_toggle, video_made_with_ai, content_posting_method

Using a different agent for TikTok?

Postiz works with any AI agent that can run CLI commands or call MCP tools, and the TikTok 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.

TikTok + Other Platforms

Schedule the same video to TikTok and other platforms in a single request. Each platform gets its own settings.

Example

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

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

Privacy Levels

Public

PUBLIC_TO_EVERYONE

Friends

MUTUAL_FOLLOW_FRIENDS

Followers

FOLLOWER_OF_CREATOR

Only You

SELF_ONLY

What can you ask Hermes Agent to do on TikTok?

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

Ask Hermes Agent

> Post clip.mp4 to TikTok as public with the caption "Behind the scenes", allow duets and comments, no stitches, tomorrow at 6pm.

Hermes uploads the video, sets privacy_level: PUBLIC_TO_EVERYONE, duet: true, stitch: false, comment: true, and schedules it.

Ask Hermes Agent

> Upload promo.mp4 to my TikTok inbox as a draft so I can add music in the app.

Hermes sets content_posting_method: UPLOAD and sends the video to your TikTok inbox.

Ask Hermes Agent

> Post this AI-generated clip to TikTok and mark it as AI content and branded content.

Hermes sets video_made_with_ai: true and brand_content_toggle: true before publishing.

TikTok rules Hermes Agent has to follow

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

▸TikTok requires a video uploaded through postiz upload. Raw file paths and external URLs are rejected.
▸privacy_level, duet, stitch, comment, autoAddMusic, and content_posting_method are all required. The Postiz skill tells Hermes to use DIRECT_POST unless you ask for an inbox upload.
▸The optional title is limited to 90 characters. The post content is the caption.
▸Use brand_content_toggle or brand_organic_toggle when a video is sponsored, and video_made_with_ai for generated footage, so TikTok labels it correctly.

Hermes Agent and TikTok: frequently asked questions

Can Hermes Agent post videos to TikTok?

Yes. With the Postiz skill installed, Hermes Agent uploads your video, sets the privacy level and interaction permissions, adds branded or AI disclosures, and publishes directly to TikTok or sends it to your inbox as a draft. You ask in plain language and Hermes runs the Postiz CLI commands.

How do I connect TikTok to Hermes Agent?

Connect your TikTok account 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 TikTok channel with postiz integrations:list. Your TikTok login stays inside Postiz; Hermes only holds the Postiz key.

What is the difference between DIRECT_POST and UPLOAD on TikTok?

DIRECT_POST publishes the video to your profile at the scheduled time. UPLOAD sends it to your TikTok inbox as a draft so you can finish it in the app, for example to add sounds. The Postiz skill instructs Hermes to use DIRECT_POST unless you explicitly ask for an inbox upload.

Can Hermes Agent control duets, stitches, and comments on TikTok?

Yes. duet, stitch, and comment are boolean settings Hermes sets from your request, such as "allow duets but no stitches". They are required fields, so if you do not mention them Hermes should confirm defaults with you. privacy_level controls who can see the video.

Can Hermes Agent post to TikTok automatically on a schedule?

Yes. Hermes Agent includes a cron scheduler. Run hermes cron create "daily at 5pm" with a prompt such as "take the newest clip in ~/content/tiktok, write a caption, and schedule it via Postiz for 7pm". Hermes runs it unattended and reports back to your chat.