AI Agent Social Media Posting with Postiz
AI agent social media posting means an AI agent such as Claude Code, ChatGPT, Cursor, or OpenClaw drafts, schedules, and publishes posts for you. Postiz is the agentic social media scheduling platform that makes this work: it exposes an MCP server, a CLI, and an installable skill, so any agent can post to 30+ platforms while you approve the plan.
Please make sure there is always a human in the loop. Last updated: September 2026
Which AI agents can post to social media with Postiz?
Seventeen agents have a dedicated Postiz guide. Each row shows how that agent connects and how it authenticates; open the guide for install steps, example prompts, and a page per platform.
| Agent | Made by | How it connects to Postiz | Authentication | Guide |
|---|---|---|---|---|
| Claude Code | Anthropic | MCP link (claude mcp add) or the Postiz skill | OAuth sign-in (MCP) or POSTIZ_API_KEY (skill) | Claude Code guide |
| Claude Cowork | Anthropic | Postiz skill (npx skills add), called through MCP tools | POSTIZ_API_KEY | Claude Cowork guide |
| Claude | Anthropic | Official connector in the Claude directory, or custom MCP link | OAuth sign-in | Claude guide |
| ChatGPT | OpenAI | Official ChatGPT connector, or custom MCP link | OAuth sign-in | ChatGPT guide |
| Codex | OpenAI | Postiz skill (SKILL.md in your project) | POSTIZ_API_KEY | Codex guide |
| Cursor | Cursor | Official Cursor Marketplace plugin, skill, or MCP server | POSTIZ_API_KEY (plugin or skill) or OAuth (MCP) | Cursor guide |
| Grok Bot | xAI and Cursor | Official plugin: /add-plugin postiz | POSTIZ_API_KEY stored as a Bot secret | Grok Bot guide |
| Grok Build | xAI | Plugin from the Postiz marketplace (bundles skill and MCP) | OAuth sign-in; POSTIZ_API_KEY optional for CLI uploads | Grok Build guide |
| Gemini | Gemini CLI extension (gemini extensions install), or custom connected app in the Gemini web app | OAuth sign-in (extension bundles the MCP server); POSTIZ_API_KEY optional for CLI uploads | Gemini guide | |
| DeepSeek | DeepSeek | DeepSeek Harness (dsh) plugin: dsh plugin --profile web add dsh-postiz | POSTIZ_API_KEY read at boot | DeepSeek guide |
| Kimi K3 | Moonshot AI | Ask Kimi Code to add the MCP link (/mcp-config) or install the Postiz skill | OAuth sign-in (MCP) or POSTIZ_API_KEY (skill) | Kimi K3 guide |
| Hermes Agent | Nous Research | Postiz skill (npx skills add) | POSTIZ_API_KEY | Hermes Agent guide |
| NanoClaw | Qwibit AI | Postiz skill (npx skills add) | POSTIZ_API_KEY | NanoClaw guide |
| OpenClaw | Open source | Skill from ClawHub or the skills CLI (not MCP) | POSTIZ_API_KEY | OpenClaw guide |
| Paperclip | Open source | Postiz skill (npx skills add) | POSTIZ_API_KEY | Paperclip guide |
| Perplexity Computer | Perplexity | Postiz skill (npx skills add) | POSTIZ_API_KEY | Perplexity Computer guide |
| Muse | Meta | MCP link pasted into a setup prompt (custom connector) | OAuth sign-in | Muse guide |
Using an MCP client that is not listed? Any MCP-compatible tool can use the Postiz MCP server. Any agent that runs shell commands can use the Postiz skill.
How do AI agents connect to Postiz?
AI agents connect to Postiz through one of three surfaces: the hosted MCP server, the Postiz skill with its CLI, or an official connector or plugin in the agent's own marketplace. All three reach the same Postiz account and the same channels.
| Surface | Used by | Authentication | Media and tools | Learn more |
|---|---|---|---|---|
| Postiz MCP server | Claude, Claude Code, ChatGPT, Cursor, Gemini CLI, Kimi Code, DeepSeek Harness, Muse, Grok Build (bundled) | OAuth sign-in with your Postiz account, no API key | Full toolset: posting, scheduling, analytics, image and video generation, clipping | Postiz MCP server guide |
| Postiz skill + CLI | Claude Code, Claude Cowork, Codex, Cursor, Gemini CLI, Kimi Code, Grok Bot, Grok Build, Hermes Agent, NanoClaw, OpenClaw, Paperclip, Perplexity Computer | POSTIZ_API_KEY from your Postiz settings | Upload images, videos, audio, and documents from disk; every command returns JSON | postiz-agent on GitHub |
| Official connectors and plugins | Claude directory, ChatGPT connectors, Cursor Marketplace, Gemini CLI extensions gallery, DeepSeek Harness plugin list, Grok Bot marketplace, Grok Build marketplace | One-click install; connectors use OAuth, plugins bundle the skill or MCP server | The Claude directory connector covers posting, scheduling, and analytics only; add the custom MCP link for media generation | Claude connector guide |
How do I connect any AI agent to Postiz?
Connecting takes three steps and about two minutes: choose the MCP link or the skill, sign in or set your key, then ask the agent to post. Each agent guide repeats these steps with the exact commands for that tool.
- 1
Pick a surface your agent supports
MCP clients (Claude, ChatGPT, Cursor, Gemini CLI, Kimi Code, Muse, Grok Build) take the hosted Postiz MCP link. Agents that run shell commands (Codex, OpenClaw, Hermes Agent, NanoClaw, Paperclip, Perplexity Computer, Claude Cowork) take the Postiz skill.Connect# Option A: MCP link (paste into your MCP client) https://mcp.postiz.com/mcp-oauth-dynamic # Option B: Postiz skill (any agent that runs commands) npx skills add gitroomhq/postiz-agent - 2
Sign in or set your API key
The MCP server opens a Postiz sign-in page and uses OAuth, so the agent only reaches accounts you already connected. The skill reads POSTIZ_API_KEY from your environment; copy the key from your Postiz settings.Authenticate# MCP: approve the sign-in page your agent opens # Skill: export the key once export POSTIZ_API_KEY=your_api_key # Verify the agent can see your channels postiz integrations:list - 3
Ask the agent to post
Describe the post in plain language. The agent lists your channels, uploads media, applies platform settings such as Reddit flairs or YouTube playlists, and schedules the post. Review the plan before it publishes.PromptYou: Schedule a LinkedIn post and an X thread about the launch for tomorrow at 9am, attach ./assets/launch.png Agent: Scheduled 2 posts for 09:00 - LinkedIn: 1 post with image - X: 3-part thread with image Want me to add Reddit r/programming too?
What can an AI agent do with Postiz?
An agent connected to Postiz can list your channels, upload media, create scheduled posts and threads, apply platform-specific settings, and read analytics. Every response is structured, so the agent can plan the next step on its own.
AI Agent Ready
Every command outputs structured JSON. Designed for LLMs and automation pipelines to parse, plan, and execute social media workflows.
30+ Platforms
Post to Twitter/X, LinkedIn, Reddit, Instagram, YouTube, TikTok, and 22 more platforms from a single CLI.
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 the Postiz CLI work for AI agents?
The Postiz CLI (postiz-agent) is the tool behind the skill. Install it once, set POSTIZ_API_KEY, and an agent can discover your channels, create posts, and read analytics with plain commands that return JSON.
# Install the skill
npx skills add gitroomhq/postiz-agent
# Set your API key
export POSTIZ_API_KEY=your_api_key
# List your connected platforms
postiz integrations:list
# Create your first post
postiz posts:create \
-c "Hello from Postiz Agent!" \
-s "2025-01-01T12:00:00Z" \
-i "your-integration-id"- 1
Discover Integrations
List all your connected social media accounts and discover platform-specific features like subreddit flairs and YouTube playlists.Discoverypostiz integrations:list # Get platform settings postiz integrations:settings <id> # Fetch platform-specific data postiz integrations:trigger <id> getFlairs \ -d '{"subreddit":"programming"}' - 2
Create Posts
Compose posts with content, media, comments, and platform-specific settings. Use simple CLI flags for quick posts or JSON files for complex campaigns.Post Creation# Simple post postiz posts:create \ -c "Check out our new feature!" \ -m "screenshot.png" \ -s "2025-01-15T09:00:00Z" \ -i "twitter-id,linkedin-id" # Complex post from JSON postiz posts:create --json campaign.json - 3
Manage & Analyze
List, filter, and manage your scheduled posts. Track performance with platform and post-level analytics. Build batch workflows to schedule entire content campaigns programmatically.Management & Analytics# List scheduled posts postiz posts:list # Get platform analytics (last 30 days) postiz analytics:platform <id> -d 30 # Get analytics for a specific post postiz analytics:post <post-id> -d 7 # Upload media for reuse postiz upload video.mp4
One Command, Every Platform
Post to multiple platforms simultaneously, each with their own media and platform-specific settings.
# Post to multiple platforms at once
postiz posts:create \
-c "Launching our new feature today!" \
-m "banner.png" \
-s "2025-03-01T09:00:00Z" \
-i "twitter-id,linkedin-id,facebook-id"
# Post with threaded comments
postiz posts:create \
-c "Main announcement post" -m "hero.png" \
-c "First follow-up comment" -m "demo.gif" \
-c "Links and resources" \
-s "2025-03-01T09:00:00Z" \
-i "twitter-id,reddit-id"
# Post with platform-specific settings
postiz posts:create \
-c "Check out this tutorial" \
-m "video.mp4" \
-s "2025-03-01T09:00:00Z" \
--settings '{"subreddit":[{"value":{"subreddit":"programming","title":"New Tutorial","type":"text"}}]}' \
-i "reddit-id"
# Batch schedule a week of content
for day in 1 2 3 4 5; do
postiz posts:create \
-c "Day $day content" \
-s "2025-03-0${day}T09:00:00Z" \
-i "twitter-id,linkedin-id"
doneCan an AI agent post on a schedule without me?
From Any Chat App
WhatsApp, Telegram, Slack, Discord...
Agents like OpenClaw and NanoClaw run as a persistent daemon and take messages from chat apps. Send one message and the agent discovers your accounts via Postiz, uploads media, and schedules the posts while you go about your day.
You: Post my blog article to Twitter,
LinkedIn, and Reddit with the cover
image, schedule for tomorrow at 9am
Agent: Done! Posts scheduled:
- X (Twitter): scheduled 9:00 AM
- LinkedIn: scheduled 9:00 AM
- Reddit (r/programming): scheduled 9:00 AM
Post ID: abc-123Scheduled & Proactive
Cron jobs for recurring content
OpenClaw supports cron automations. Set up a recurring job that checks for new content and posts it to all your platforms automatically, with no manual trigger needed.
{
"heartbeat": [
{
"cron": "0 9 * * 1-5",
"prompt": "Check ~/content/pending
for new posts. Upload any media,
then schedule to Twitter, LinkedIn,
and Instagram for today at noon.
Move posted files to ~/content/done."
}
]
}Why AI Agents Work Well with Postiz
- Every command returns structured JSON for easy parsing
- Built-in SKILL.md provides full command documentation
- Discovery workflow lets agents explore available platforms
- Platform-specific tools (flairs, playlists, boards) are dynamically queryable
- No SDK needed: any agent that can run CLI commands or call MCP tools works
- Model-agnostic: works with Claude, GPT, Grok, Gemini, or open-source LLMs
---
name: postiz
description: Social media automation
CLI for scheduling posts across
30+ platforms
metadata:
openclaw:
requirements:
env:
- POSTIZ_API_KEY
binaries:
- postiz
---
# Available Commands
- postiz integrations:list
- postiz integrations:settings <id>
- postiz posts:create
- postiz upload <file>
- postiz analytics:platform <id>Command Reference
| Command | Description |
|---|---|
postiz integrations:list | List all connected social media accounts |
postiz integrations:settings <id> | Get platform-specific settings schema |
postiz integrations:trigger <id> <method> | Trigger platform tools (flairs, playlists, etc.) |
postiz posts:create | Create and schedule a new post |
postiz posts:list | List all scheduled and published posts |
postiz posts:delete <id> | Delete a scheduled post |
postiz analytics:platform <id> | Get analytics for an integration/channel |
postiz analytics:post <id> | Get analytics for a specific post |
postiz upload <file> | Upload media and get a reusable URL |
Which platforms can an AI agent post to through Postiz?
Postiz connects 30+ channels, and every agent guide has a page for each of the 25 platforms below with settings reference, example prompts, and gotchas. For an agent-specific walkthrough, see for example Claude Code on X or OpenClaw on Reddit.
X (Twitter)
Tweets, threads, and reply controls
Professional posts and image carousels
Feed posts, stories, and reels
Text posts, links, and media
Subreddits, flairs, and post types
YouTube
Video uploads, thumbnails, and tags
TikTok
Videos, privacy, duets, and stitches
Pins, boards, and link pins
Discord
Channel messaging and media
Slack
Channel messaging and team updates
Telegram
Bot-powered channel messaging
Twitch
Chat messages and announcements
Kick
Chat messages and notifications
Medium
Articles, publications, and tags
Dev.to
Developer articles and organizations
Hashnode
Blog posts and publications
WordPress
Posts, pages, and featured images
Dribbble
Design shots and team portfolios
Warpcast
Farcaster casts and channels
Lemmy
Federated community posts
Moltbook
AI agent social network
Google My Business
Business posts, events, and offers
Listmonk
Email campaigns and newsletters
Skool
Community posts and groups
Whop
Company forums and experiences
Frequently Asked Questions
What is AI agent social media posting?
Which AI agents can post to social media with Postiz?
Do I need a Postiz API key for my AI agent?
What is the difference between the Postiz MCP server, the skill, and the CLI?
Is OpenClaw the same as MCP?
Claude Code, Claude Cowork, and the Claude connector: which one do I need?
Is Grok Bot the same as Grok or Grok Build?
Can an AI agent post to social media on a schedule without me?
Is Postiz free to use with AI agents?
Which social media platforms can an AI agent post to through Postiz?
Want the protocol details? Read the Postiz MCP server guide. Wondering what it costs? See Postiz pricing. Last updated: September 2026.
Start automating today
Connect your AI agent to Postiz and let it handle social media posting across all your platforms.