Publish to Medium from Paperclip

Paperclip agents can publish and schedule Medium articles through Postiz. Install the Postiz skill where the agent runs, connect your Medium account in Postiz, and the agent can turn a Markdown draft into an article with a title, subtitle, tags, an optional publication, and a canonical URL pointing back to your own blog.

Setup Guide Paperclip

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

Last updated: September 2026

Publish to Medium 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 Paperclip:
> Publish my draft article on Medium
  under our publication, tomorrow at 9am

Paperclip: Done! Your Medium post is scheduled.

Medium-Specific Features

📝

Article Publishing

Publish long-form articles directly to Medium with full Markdown support. Write once, publish seamlessly.

📚

Publication Support

Publish articles under any Medium publication you belong to. Reach established audiences with a single setting.

🔗

Canonical URLs

Set canonical URLs for SEO to link back to your original content. Avoid duplicate content penalties across platforms.

🏷

Smart Tagging

Add up to 4 tags per article to improve discoverability. Tags help Medium surface your content to the right readers.

📅

Scheduled Publishing

Schedule articles for future publication with precise timestamps. Plan your content calendar weeks in advance.

🤖

AI-Powered Workflows

Let AI agents draft, format, and publish your articles. From idea to published post without leaving your chat app.

How does Paperclip post to Medium?

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

Find Your Medium Integration

Ask Paperclip whether your Medium account is connected. It also checks which options the platform supports.

Example conversation

> Is my Medium account connected to Postiz?

Paperclip: Yes — your Medium account is connected
  and ready. Want me to post something?

Write Your Article

Compose your article content in Markdown. Medium supports rich formatting including headers, code blocks, images, and embedded links.

Example conversation

> Draft a Medium post about our new
  feature launch

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

Publish Your Article

Create a post with your article content, title, subtitle, tags, and optional publication and canonical URL settings.

Example conversation

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

Paperclip: Done! Scheduled on Medium for
  tomorrow at 9:00 AM.

Medium Settings Reference

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

Field	Type	Required	Description
`__type`	string	Yes	Must be "medium"
`title`	string	Yes	Article title (min 2 characters)
`subtitle`	string	Yes	Article subtitle (min 2 characters)
`canonical`	string	No	Original URL for SEO canonical link
`publication`	string	No	Publication ID to publish under
`tags`	array	No	Up to 4 tags: [{value: string, label: string}]

Common Configurations

Ask Paperclip for any of these common Medium publishing scenarios and it applies the matching settings.

Simple Article with Tags

Just ask

> Post it with: Simple Article with Tags

Paperclip: Got it. Applying:
  title: Getting Started with TypeScript
  subtitle: A beginner-friendly introduction
  tags: TypeScript, JavaScript, Programming

Cross-Posted Article with Canonical URL

Just ask

> Post it with: Cross-Posted Article with Canonical URL

Paperclip: Got it. Applying:
  title: How We Scaled to 1M Users
  subtitle: Lessons from our growth journey
  canonical: https://engineering.myblog.com/scaling-to-1m
  tags: Startup, Scaling, Engineering

Publication Article

Just ask

> Post it with: Publication Article

Paperclip: Got it. Applying:
  title: The Future of AI Agents
  subtitle: Why autonomous agents are the next paradigm
  publication: towards-data-science-id
  tags: Artificial Intelligence, AI Agents, Automation, Future

What is Paperclip?

Paperclip is an open-source orchestration framework for building “zero-human companies” by hiring and managing teams of AI agents. It handles content, social media distribution, marketing, dev, QA, and more from a single dashboard.

👥

Agent Teams

Paperclip manages teams of AI agents that work together. Assign a content agent, a scheduling agent, and a review agent to your social media workflow.

📊

Single Dashboard

Monitor all your AI agents and their social media tasks from one unified dashboard. Track posts, schedules, and performance in real time.

⚙

Orchestration

Schedule recurring tasks with cron jobs. Paperclip can publish your Medium articles on a schedule without you having to ask each time.

How Postiz Works with Paperclip

When you install Postiz Agent globally, Paperclip automatically discovers it by reading the bundled SKILL.md file. This file tells Paperclip what commands are available, what environment variables are needed, and how to compose Medium articles with the right settings.

✓Install Postiz Agent and set your POSTIZ_API_KEY
✓Paperclip discovers Postiz through tool integration
✓Assign Postiz commands to specialized agents in your team
✓Orchestrate multi-step workflows with approval chains
✓Monitor everything 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
# its tool integration system
# and assigns it to agent teams

Medium Publishing with Paperclip

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

📎

From Any Chat App

Paperclip assigns specialized agents to ...

Assign a task to Paperclip from its dashboard. It runs as a long-lived service on your own infrastructure, so it picks up the task, discovers your Medium account via Postiz, formats the article, and publishes it — all while you go about your day.

Paperclip

Content Agent: Drafted a post about
  the feature launch for Medium.

Review Agent: Approved with minor
  edits. Ready to publish.

Scheduling Agent: Found Medium
  integration via Postiz.
  Scheduled for tomorrow 9:00 AM.

  Post ID: abc-123
  Status: Scheduled

📎

Scheduled & Proactive

Paperclip orchestrates recurring co...

Paperclip supports scheduled heartbeats. Set up a recurring job that checks a folder for new Markdown drafts and publishes them to Medium automatically — no manual trigger needed.

paperclip.yaml (pipeline)

pipelines:
  daily_social:
    schedule: "0 9 * * 1-5"
    agents:
      - role: content_creator
        task: "Draft a Medium post
          about trending industry topics"
      - role: reviewer
        task: "Review and polish the
          draft for engagement"
      - role: publisher
        task: "Schedule via Postiz
          for today at noon"

Why Paperclip + Postiz for Medium

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

✓Multi-agent teams for quality Medium content — draft, review, publish
✓Single dashboard to monitor all social media automation
✓Orchestrated pipelines from content creation to publishing
✓Scheduled pipelines for hands-free daily posting
✓Cross-post to Medium + other platforms in a single pipeline
✓Open-source — fully customizable agent workflows

SKILL.md (auto-discovered)

---
name: postiz
description: Social media automation
  CLI for scheduling posts across
  30+ platforms including Medium
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>

# Medium Settings
title, subtitle, canonical,
publication, tags

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 Anthropic's Claude Code.

Claude Code

by Anthropic

Claude reads the Postiz skill so it knows what it can do, then autonomously discovers your Medium integration, formats your article, applies tags and publication settings, and publishes the post.

Claude Code

> Publish my API design article to Medium
  under the engineering publication with
  a canonical URL back to my blog

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

Medium + Other Platforms

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

Example

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

Paperclip: Done! Scheduled:
  - Medium + LinkedIn: tomorrow 9:00 AM
  - Daily tips on Medium: Mon-Fri 10:00 AM

What can you ask Paperclip to do on Medium?

You assign a task in plain language and the agent translates it into Postiz calls with the right Medium settings. These are prompts people actually give a Paperclip agent for Medium.

Cross-post with canonical

Ask Paperclip

> Publish blog/observability.md to Medium with
  the canonical set to our blog URL, tags:
  devops, monitoring, schedule for Monday 8am

Paperclip: title, subtitle, canonical, 2 tags set.
  Scheduled on Medium for Mon 8:00 AM.

Publication

Ask Paperclip

> Submit the article to our "Engineering Notes"
  publication instead of my profile

Paperclip: publication resolved. Ready to schedule.

Series

Ask Paperclip

> Publish the 4-part series in ./series to Medium,
  one part every Tuesday

Paperclip: 4 articles queued, Tuesdays 8:00 AM,
  each with a canonical link.

What Medium rules should the agent follow?

Medium rejects posts that break its limits, so the agent needs these constraints up front. Put them in the task or in your Paperclip agent's instructions.

✓title and subtitle are both required and need at least 2 characters each. Ask the agent to write a subtitle if your draft lacks one.
✓Set canonical to the original URL when cross-posting from your blog so search engines credit your site, not Medium.
✓Postiz accepts up to 4 tags per article, as label and value pairs. Tags drive Medium's topic distribution.
✓publication is optional. Your Medium account must already be a writer or editor of that publication for the submission to succeed.

Paperclip and Medium: frequently asked questions

Short answers to the questions teams ask before letting a Paperclip agent post to Medium through Postiz.

How do I publish to Medium from Paperclip?

Install the Postiz skill in your agent's environment with npx skills add gitroomhq/postiz-agent, set POSTIZ_API_KEY, and connect your Medium account in Postiz. Then assign a task such as "publish this article to Medium Monday at 8am with a canonical link" and the agent formats and schedules it.

Can a Paperclip agent cross-post my blog to Medium without hurting SEO?

Yes. Ask the agent to set the canonical field to the original blog URL. Medium then tells search engines your site is the source, so the Medium copy does not compete with it. This is the standard way to syndicate content and is built into the Postiz Medium settings.

Can Paperclip publish to a Medium publication?

Yes. Name the publication in the task and the agent sets the publication ID, as long as your Medium account is already a writer or editor there. Some publications review submissions before they go live, so the article may appear as pending rather than published immediately.

How many tags can Postiz add to a Medium article?

Postiz accepts up to 4 tags per Medium article. Each tag is a value and label pair that the agent fills from your request or from the article's topic. Choose tags that match existing Medium topics, since those feed the platform's recommendation system.

Can Paperclip run a recurring Medium publishing schedule?

Yes. A writer agent drafts from your notes or blog feed, a reviewer agent checks the draft, and a publisher agent schedules it through Postiz, all coordinated by Paperclip heartbeats. Paperclip's approval gates let a person read each article before the publisher runs.