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 makes this work: it is an open-source social media scheduling platform that exposes an MCP server, a CLI, and an installable skill, so any agent can post to 30+ platforms while you approve the plan.
Last updated: September 2026
Please make sure there is always a human in the loop.
Which AI agents can post to social media with Postiz?
Fourteen 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.
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-agentSign 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:listAsk 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.
Prompt
You: 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.
Terminal
# 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"Discover Integrations
List all your connected social media accounts and discover platform-specific features like subreddit flairs and YouTube playlists.
Discovery
postiz integrations:list
# Get platform settings
postiz integrations:settings <id>
# Fetch platform-specific data
postiz integrations:trigger <id> getFlairs \
-d '{"subreddit":"programming"}'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.jsonManage & 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.mp4One Command, Every Platform
Post to multiple platforms simultaneously, each with their own media and platform-specific settings.
Terminal
# 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?
Yes. Agents with recurring jobs can run Postiz headless: OpenClaw has cron automations, NanoClaw has built-in scheduled jobs, and Grok Bot runs always-on Bots on a routine. Keep a human approving the queue.
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.
WhatsApp / Telegram
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.
openclaw.json (heartbeat)
{
"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
SKILL.md (auto-discovered)
---
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?
It is when an AI agent, rather than a person clicking through a dashboard, drafts, schedules, and publishes posts on your connected accounts. With Postiz the agent calls the MCP server, the CLI, or the installed skill, picks the right channels, applies platform settings, and schedules the post while you review the plan.
Which AI agents can post to social media with Postiz?
Postiz has guides for 17 agents: Claude Code, Claude Cowork, Claude, ChatGPT, Codex, Cursor, Gemini, DeepSeek Harness, Kimi K3, Grok Bot, Grok Build, Hermes Agent, NanoClaw, OpenClaw, Paperclip, Perplexity Computer, and Meta Muse AI. Any other agent that can call an MCP server or run shell commands also works, because Postiz Agent is a plain CLI with a bundled SKILL.md.
Do I need a Postiz API key for my AI agent?
It depends on the surface. The Postiz MCP server and the official connectors sign you in with OAuth, so no API key is needed and the agent only reaches accounts you already connected. The CLI skill installed with npx skills add reads a POSTIZ_API_KEY environment variable, which you copy from your Postiz settings.
What is the difference between the Postiz MCP server, the skill, and the CLI?
The MCP server is a hosted endpoint (mcp.postiz.com/mcp-oauth-dynamic) that exposes Postiz as tools for MCP clients like Claude, ChatGPT, and Cursor. The skill is a SKILL.md file installed with npx skills add that teaches an agent the Postiz CLI. The CLI is the postiz command itself, which returns structured JSON for every call.
Is OpenClaw the same as MCP?
No. OpenClaw is an open-source personal AI agent that extends itself with Markdown skills, and Postiz connects to it as a skill from ClawHub or the skills CLI, not as an MCP server. MCP (Model Context Protocol) is the standard that Claude, ChatGPT, Cursor, Gemini CLI, Kimi Code, Muse, and Grok Build use to call the hosted Postiz server.
Claude Code, Claude Cowork, and the Claude connector: which one do I need?
Use the Claude connector if you chat with Claude on the web, desktop, or mobile; add Postiz from the Claude directory or paste the MCP link. Use Claude Code if you work in the terminal and want claude mcp add. Use Claude Cowork if you delegate desktop tasks; it runs the Postiz skill and MCP tools for you.
Is Grok Bot the same as Grok or Grok Build?
No. Grok is the chatbot on X and grok.com. Grok Bot is the always-on AI teammate product from xAI and Cursor, where named Bots run 24/7 on their own cloud computers and install Postiz with /add-plugin postiz. Grok Build is xAI's coding agent and CLI, which installs the Postiz plugin from a marketplace.
Can an AI agent post to social media on a schedule without me?
Yes, if the agent supports scheduled or recurring jobs. OpenClaw runs cron automations, NanoClaw has built-in scheduled jobs, and Grok Bot works on a routine. Each can check a content folder and schedule posts through Postiz. We still recommend keeping a human in the loop to approve what goes out.
Is Postiz free to use with AI agents?
Postiz offers a 7-day free trial on the hosted service, and the open-source version can be deployed on your own cloud for free. The MCP server, CLI, and skill work with either. Plan details and limits are on the pricing page, and every agent guide on this site starts from the same free trial.
Which social media platforms can an AI agent post to through Postiz?
Postiz connects 30+ channels, and each agent guide has dedicated pages for 25 of them: X, LinkedIn, Instagram, Facebook, Reddit, YouTube, TikTok, Pinterest, Discord, Slack, Telegram, Twitch, Kick, Medium, Dev.to, Hashnode, WordPress, Dribbble, Warpcast, Lemmy, Moltbook, Google My Business, Listmonk, Skool, and Whop. Platform-specific settings like Reddit flairs are discovered dynamically.
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.
Ready to get started?
Grow your social media presence with Postiz.
Schedule, analyze, and engage with your audience.
Agentic social media scheduler (cloud / open-source)
AI Agents
