logo
PaperclipPaperclip + Postiz

Schedule Social Media Posts with Paperclip

  • Install the Postiz skill where your agents run
  • Any agent in your Paperclip org posts to 30+ platforms
  • Approvals and budgets keep a human in the loop
View Docs

Postiz is the agentic social media scheduling platform that Paperclip agents drives through the Postiz skill. Please make sure there is always a human in the loop. Last updated: September 2026. Part of the Postiz AI agents guide.

Set Up Once, Then Just Ask

One skill install in the environment where your Paperclip agents execute. After that, any task that mentions posting runs through Postiz.

1Install
about ten minutes

Install the Postiz skill

Run this where your agents execute, not only on your laptop. It installs the postiz CLI and a SKILL.md the agent reads to learn the commands.

agent environment
# One-time setup, where your agents run
npx skills add gitroomhq/postiz-agent
export POSTIZ_API_KEY=your_api_key

# Verify
postiz integrations:list

Create the API key in Postiz under Settings, Developers, Public API. MCP-capable agents can use the hosted Postiz MCP server instead.

2Ask
live in Postiz

Assign a posting task

Give an agent a goal in Paperclip. It runs the Postiz CLI, and Postiz publishes at the scheduled time even after the task closes.

Post "Hello from Postiz!" to X and LinkedIn, schedule it for tomorrow at 9am

Paperclip

Done. Ran postiz posts:create for X and LinkedIn, scheduled for tomorrow at 9:00 AM. Post IDs are attached to this task for review.

via PostizXLinkedin

Also try

List my connected social media accountsWhat's scheduled this week?Cancel tomorrow's LinkedIn post
  1. 1Install Paperclip from paperclip.ing or with npx paperclipai onboard
  2. 2Run npx skills add gitroomhq/postiz-agent where your agents execute
  3. 3Set POSTIZ_API_KEY or run postiz auth:login, then connect channels in Postiz
  4. 4Assign a posting task in Paperclip and review the result in its dashboard

One skill install powers every channel your agents run

Connect your accounts in Postiz once. From then on any agent in your Paperclip org can post to all of them, and Postiz publishes at the time it set.

Paperclip
XLinkedInInstagramFacebookThreadsRedditYouTubeTikTokPinterestBlueskyDiscordSlackGoogle BusinessTelegramMastodonDribbbleWordPressMediumHashnodeDev.toTwitchKickWarpcastNostrLemmyVKMeWeWhopSkoolListmonk

Why use Postiz with Paperclip?

Postiz gives Paperclip agents one tool for every social channel, with structured output they can verify, so a posting pipeline needs no per-platform code.

AI Agent Ready

Postiz returns structured results, so Paperclip can plan, run, and verify multi-step social media workflows on its own.

30+ Platforms

Post to Twitter/X, LinkedIn, Reddit, Instagram, YouTube, TikTok, and 22 more platforms. One request from you, Paperclip 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 Paperclip post to social media with Postiz?

You assign a task in plain language and the Paperclip agent translates it into Postiz CLI calls: list channels, upload media, create the post, check results. Here is how a typical exchange goes.

  1. 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?

Paperclip: You have 4 channels connected:
  X, LinkedIn, Reddit, and YouTube.
  I can also check platform options like
  subreddit flairs or YouTube playlists.
  2. 2

    Create Posts

    Describe the post — content, media, comments, and any platform options — and Paperclip builds it, 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

Paperclip: Done! Scheduled on X and LinkedIn
  for tomorrow at 9:00 AM with the image.
  3. 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 Paperclip schedules the whole campaign.
    Example conversation
    > What's scheduled this week, and how did
  last month's posts perform?

Paperclip: 5 posts scheduled Mon-Fri.
  Last 30 days: 12.4k impressions, up 18%.
  Your best post was Tuesday's launch thread.

One Request, Every Platform

Ask once and Paperclip posts to every platform at the same time, each with its own media and settings. For example:

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.

Paperclip: 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 LinkedIn

What is Paperclip?

Paperclip is an open-source, MIT-licensed platform for managing teams of AI agents at work, described by its makers as orchestration for "zero-human companies". It organizes agents such as Claude Code, Codex, Cursor, and OpenClaw into an org chart with goals, budgets, approval workflows, and heartbeat schedules, all self-hosted with no Paperclip account required. Postiz is the tool those agents use for social media.

Agent Teams

Manages teams of AI agents working together. Assign content, scheduling, and review agents to handle your entire social media workflow collaboratively.

Single Dashboard

Monitor all agents and tasks from one unified dashboard. Track content pipelines, scheduling status, and agent performance in real time.

Orchestration

Chain multi-agent workflows with approval gates and handoffs. Build sophisticated content pipelines where agents collaborate on drafting, reviewing, and publishing.

How Postiz Works with Paperclip

Postiz integrates as a tool in Paperclip's orchestration framework. Once configured, your agent teams can call Postiz commands as part of multi-step workflows — from content creation to cross-platform publishing.

  • Install Postiz Agent and set your POSTIZ_API_KEY
  • Paperclip discovers Postiz through tool integration
  • Assign Postiz capabilities to specialized agents
  • Orchestrate multi-step workflows with approval chains
  • Monitor all social media activity from the Paperclip dashboard
Install Postiz
# Install the Postiz skill
npx skills add gitroomhq/postiz-agent

# Set your API key
export POSTIZ_API_KEY=your_api_key

# Paperclip discovers Postiz through
# tool integration and assigns it
# to your agent teams

Orchestrated Social Media

Let Paperclip coordinate your agent teams to handle the entire social media pipeline — from content creation to review to publishing across all your platforms.

Multi-Agent Flow

Coordinated agent teams

Paperclip coordinates multiple agents to handle the complete content lifecycle. The Content Agent drafts, the Review Agent approves, and the Scheduling Agent publishes — all orchestrated automatically.

Paperclip Pipeline
Content Agent: Drafting post about
  our new feature launch...
  -> Generated 3 platform variants

Review Agent: Reviewing drafts...
  -> Twitter variant: Approved
  -> LinkedIn variant: Minor edit applied
  -> Reddit variant: Approved

Scheduling Agent: Publishing via Postiz
  1. Uploading media assets
  2. Scheduling across 3 platforms

  Done! Posts scheduled:
  - X (Twitter): scheduled 9:00 AM
  - LinkedIn: scheduled 9:00 AM
  - Reddit (r/programming): scheduled 9:30 AM

Content Pipelines

Declarative workflow config

Define your content pipeline in a paperclip.yaml file. Assign roles to agents and let Paperclip orchestrate the entire flow from creation to publishing.

paperclip.yaml
pipeline: social_media
schedule: "weekdays 9am"
tools:
  - postiz-agent

roles:
  content_creator:
    task: "Draft platform-specific posts"
    output: drafts/

  reviewer:
    task: "Review and approve drafts"
    requires: content_creator
    approval: true

  publisher:
    task: "Schedule approved posts via Postiz"
    requires: reviewer
    platforms:
      - twitter
      - linkedin
      - reddit

Why Paperclip + Postiz

  • Multi-agent teams — coordinate content, review, and publishing agents
  • Single dashboard — monitor all agents and social media tasks
  • Orchestrated pipelines — chain agent workflows with approval gates
  • Scheduled pipelines — automate recurring content workflows
  • Cross-post to 30+ platforms from coordinated agent teams
  • Paperclip is open-source and Postiz exposes a full public API
SKILL.md (auto-discovered)
---
name: postiz
description: Social media automation
  CLI for scheduling posts across
  30+ platforms
metadata:
  paperclip:
    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>

Also Works with Claude Code

Postiz works with any AI agent that can run commands or call MCP tools — you ask, the agent does the work. That includes Claude Code, Anthropic's agentic coding tool.

Claude Code

Anthropic's agentic coding tool

Claude Code reads the Postiz skill so it knows what it can do. It autonomously discovers your integrations, uploads media, composes posts with platform-specific settings, and schedules content across all your connected platforms.

Claude Code
> Schedule a tweet for tomorrow morning
  announcing our new feature, attach
  the screenshot from ./assets/launch.png

Claude Code: Done! Scheduled on X for
  tomorrow at 9:00 AM.

What can you ask Paperclip to do with Postiz?

Anything the Postiz CLI can do: list channels, fetch platform options, create and schedule posts, cancel them, upload media, and pull analytics. A few tasks people assign to Paperclip agents.

Discovery

Check what is connected

Which accounts do I have connected?

Scheduling

Schedule across channels

Post this to X and LinkedIn tomorrow at 9am

Platform options

Fetch live Reddit flairs

What flairs are available in r/programming?

Analytics

Report on last month

How did my X account do last month?

How do I connect Postiz to Paperclip?

Four steps, about ten minutes. The Postiz skill goes wherever your Paperclip agents actually execute, and your social accounts stay connected inside Postiz.

  1. 1

    Install Paperclip

    Paperclip is self-hosted and needs no account. Use the installer from paperclip.ing, or start an instance with npx. Then add the agents you want to manage, such as Claude Code or Codex.
    Terminal
    # Managed install
curl -fsSLO https://paperclip.ing/install.sh
bash install.sh

# Or without a permanent install
npx paperclipai onboard
  2. 2

    Install the Postiz skill where agents run

    The skill installs the postiz CLI and a SKILL.md the agent reads to learn the commands. Run it in the execution environment of each agent that should post, not only on your laptop.
    Agent environment
    npx skills add gitroomhq/postiz-agent

# Check the CLI is on the path
postiz --help
  3. 3

    Authenticate to Postiz

    Create an API key in Postiz under Settings, Developers, Public API, or log in with OAuth from the CLI. Connect your social channels in the Postiz dashboard; agents never hold those logins.
    Agent environment
    # Option A: API key
export POSTIZ_API_KEY=your_api_key

# Option B: OAuth login
postiz auth:login

# Verify
postiz integrations:list
  4. 4

    Assign a posting task

    Give an agent a goal in Paperclip. It discovers your channels, uploads media, creates the post with the right platform settings, and reports back in the dashboard for approval.
    Paperclip task
    > Post the launch thread to X and LinkedIn
  tomorrow at 9am, then report the post IDs

Agent: Uploaded banner.png, scheduled on
  X and LinkedIn for 9:00 AM. Post IDs
  attached to this ticket for review.

Should Paperclip agents use the Postiz CLI or the MCP server?

Use the CLI skill for agents that run shell commands on a schedule; use the MCP server for chat-first agents that support MCP. Both reach the same Postiz account and channels.

AspectPostiz CLI skillPostiz MCP server
How the agent reaches PostizRuns the postiz CLI installed by the skill (npx skills add gitroomhq/postiz-agent)Calls tools on the hosted MCP server at mcp.postiz.com/mcp-oauth-dynamic
AuthenticationPOSTIZ_API_KEY from Postiz Settings, Developers, Public API, or postiz auth:login (OAuth)OAuth in the browser when the agent connects; no key in the environment
Works with Paperclip agents thatCan run shell commands: Claude Code, Codex, and other CLI adaptersSupport MCP servers natively (Claude, Cursor, ChatGPT and similar clients)
Media uploadpostiz upload <file> from the agent's machineUpload from a URL or through the MCP upload tools
Best forHeadless pipelines, cron-style heartbeats, custom serversChat-first agents and quick setup without a local install

Details on the MCP option are on the Postiz MCP server page. For agents outside Paperclip, see Postiz for any AI agent.

Which platforms can Paperclip post to?

Postiz supports 30+ channels, and these 25 have a dedicated Paperclip guide with example prompts, a settings reference, platform rules, and an FAQ.

X (Twitter)

Tweets, threads, and reply controls

LinkedIn

Professional posts and image carousels

Instagram

Feed posts, stories, and reels

Facebook

Text posts, links, and media

Reddit

Subreddits, flairs, and post types

YouTube

Video uploads, thumbnails, and tags

TikTok

Videos, privacy, duets, and stitches

Pinterest

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

Is it safe to let Paperclip agents post for you?

Yes, if you keep credentials in Postiz and decisions in Paperclip. Agents never see your social logins, and every post can pass an approval gate before it is scheduled.

  • Social networks are connected to Postiz once with OAuth. Agents hold only a Postiz API key or CLI login, which you can revoke in Postiz Settings at any time.
  • Paperclip adds approval workflows, per-agent budgets that stop agents at a limit, and an audit log of what each agent did.
  • Schedule posts a little ahead of time instead of publishing immediately, so a reviewer can still cancel with "cancel tomorrow's LinkedIn post".
  • Give every Paperclip agent the same Postiz API key so they share channels, drafts, and the approval flow.

Paperclip and Postiz: frequently asked questions

Short answers to what teams ask before wiring social media into a Paperclip org.

What is Paperclip?

Paperclip is an open-source, MIT-licensed platform for managing teams of AI agents at work. It arranges agents such as Claude Code, Codex, Cursor, and OpenClaw into an org chart with goals, budgets, approval workflows, and heartbeat schedules. It is self-hosted and needs no Paperclip account. Postiz is one of the tools those agents can use.

How do I connect Postiz to Paperclip?

Install the Postiz skill with npx skills add gitroomhq/postiz-agent in the environment where your Paperclip agent executes, then set POSTIZ_API_KEY or run postiz auth:login. Connect your social channels in the Postiz dashboard. From then on, any task you assign in Paperclip that mentions posting is carried out through Postiz.

Is Paperclip the same as OpenClaw?

No. OpenClaw is an individual agent runtime; Paperclip is the layer that organizes many agents into a company, and it can run OpenClaw as one of them. The Paperclip team puts it as: if OpenClaw is an employee, Paperclip is the company. Postiz works with both, through the CLI skill or the MCP server.

Which Paperclip agents can post to social media with Postiz?

Any agent Paperclip can run. Claude Code and Codex adapters use the Postiz CLI skill directly. MCP-capable agents can connect to the hosted Postiz MCP server instead. The agent only needs a Postiz API key or OAuth login; your social accounts stay connected inside Postiz, never in the agent's environment.

Can Paperclip post to social media on a schedule without me?

Yes, with guardrails. Paperclip wakes agents on heartbeats, and Postiz schedules each post for an exact time, so a daily or weekly routine runs unattended. Use Paperclip's approval workflows and per-agent budgets so a reviewer agent or a person signs off before anything is published under your brand.

Which social platforms can Paperclip post to through Postiz?

Postiz supports 30+ channels. This site has a Paperclip guide 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. Each guide lists that platform's settings and example prompts.

How much does it cost to use Postiz with Paperclip?

Paperclip is free and open source under the MIT license. Postiz Cloud has a 7-day free trial, and every plan includes the same CLI and public API. Pricing for the cloud plans is on the Postiz pricing page.

Is it safe to give Paperclip agents access to my social accounts?

Agents never receive your social logins. You connect each network to Postiz with OAuth once, and agents hold only a Postiz API key or a CLI login that you can revoke in Postiz Settings. Combine that with Paperclip's approval gates and budgets, and keep a human in the loop for anything public.

Why does my Paperclip agent say the postiz command is missing?

The skill has to be installed in the environment where that agent actually executes, not only on your laptop. Run npx skills add gitroomhq/postiz-agent there, confirm POSTIZ_API_KEY is set for that process, and test with postiz integrations:list. If posts fail in bursts, check the Postiz rate limit on post creation (self-hosted admins can raise it with API_LIMIT).

Related guides

Paperclip is one way to run Postiz from an agent. These pages cover the MCP option, other agents Paperclip can manage, and pricing.

Postiz for any AI agent

How Postiz works with Claude, ChatGPT, Codex, Cursor, OpenClaw, and more.

Postiz MCP server

Connect MCP-capable agents with one OAuth link instead of the CLI skill.

OpenClaw social media

Run Postiz from OpenClaw, an agent Paperclip can also manage.

Claude Code social media

The Postiz skill inside Claude Code, a common Paperclip adapter.

Codex social media

Post with OpenAI Codex, another agent Paperclip can run.

Postiz pricing

7-day cloud trial, with agent access on every plan.

Start automating today

Set up Postiz once and let Paperclip handle your social media posting across every platform — you just ask.

Get Started