Automate Reddit with Claude Code

Post to multiple subreddits, target specific communities with flairs, choose post types, and cross-post content — just by asking Claude Code.

Setup Guide GitHub

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

Post to Reddit 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 Claude Code:
> Post our tutorial to r/programming
  with the "Tutorial" flair, tomorrow at 9am

Claude Code: Done! Your Reddit post is scheduled.

Reddit-Specific Features

🎯

Subreddit Targeting

Post to one or multiple subreddits simultaneously. Target the exact communities where your content belongs.

📝

Post Types

Create self posts, link posts, image posts, or video posts. Each type is optimized for Reddit's native rendering.

🏷

Flair Support

Automatically discover and apply required flairs for each subreddit. Never have a post rejected for missing flair again.

🔄

Cross-Posting

Share content across multiple subreddits in a single request. Each subreddit gets its own title and flair configuration.

🔗

Link & Media Posts

Share URLs, images, or videos directly. Link posts drive traffic while media posts maximize engagement within Reddit.

📅

Scheduled Posting

Schedule Reddit posts for peak activity times. Hit the front page by posting when your target subreddits are most active.

How It Works

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

Find Your Reddit Integration

Ask Claude Code whether your Reddit account is connected. It can also look up available flairs for any subreddit before posting.

Example conversation

> Is my Reddit account connected to Postiz?

Claude Code: Yes — your Reddit account is connected
  and ready. Want me to post something?

Choose Your Post Type

Reddit supports multiple post types. Self posts contain text, link posts share URLs, and image/video posts upload media directly. Pick the right type for your content.

Example conversation

> Draft a Reddit post about our new
  feature launch

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

Create Your Post

Schedule a Reddit post with your content, target subreddit, post type, and flair. You can post to multiple subreddits at once by adding more items to the subreddit array.

Example conversation

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

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

Reddit Settings Reference

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

Field	Type	Required	Description
`__type`	string	Yes	Must be "reddit"
`subreddit`	array	Yes	Array of subreddit targets: [{value: {subreddit, title, type, url?, is_flair_required, flair?}}]
`subreddit[].value.subreddit`	string	Yes	Name of the subreddit to post to (without r/ prefix)
`subreddit[].value.title`	string	Yes	Title of the Reddit post
`subreddit[].value.type`	string	Yes	Post type: "self", "link", "image", or "video"
`subreddit[].value.url`	string	No	URL for link-type posts
`subreddit[].value.is_flair_required`	boolean	Yes	Whether the subreddit requires a flair
`subreddit[].value.flair`	object	No	Flair object with id and name (required if is_flair_required is true)
`subreddit[].value.flair.id`	string	No	Flair template ID from the subreddit
`subreddit[].value.flair.name`	string	No	Display name of the flair

Common Configurations

Ask Claude Code for any of these common Reddit scenarios and it applies the matching settings.

Simple Self Post

Just ask

> Post it with: Simple Self Post

Claude Code: Got it. Applying:
  subreddit: {'subreddit': 'programming', 'title': 'Check out this new open-source tool', 'type': 'self', 'is_flair_required': False}

Link Post with Flair

Just ask

> Post it with: Link Post with Flair

Claude Code: Got it. Applying:
  subreddit: {'subreddit': 'webdev', 'title': 'How we built our scheduling engine', 'type': 'link', 'url': 'https://example.com/blog/scheduling-engine', 'is_flair_required': True, 'flair': {'id': 'abc123', 'name': 'Article'}}

Cross-Post to Multiple Subreddits

Just ask

> Post it with: Cross-Post to Multiple Subreddits

Claude Code: Got it. Applying:
  subreddit: {'subreddit': 'programming', 'title': 'New open-source social media tool', 'type': 'self', 'is_flair_required': False}, {'subreddit': 'opensource', 'title': 'We just open-sourced our social media scheduler', 'type': 'link', 'url': 'https://github.com/example/project', 'is_flair_required': False}

Image Post

Just ask

> Post it with: Image Post

Claude Code: Got it. Applying:
  subreddit: {'subreddit': 'dataisbeautiful', 'title': 'Social media engagement trends 2025', 'type': 'image', 'is_flair_required': True, 'flair': {'id': 'def456', 'name': 'OC'}}

What is Claude Code?

Claude Code is Anthropic's agentic coding tool that lives in your terminal. It handles software engineering tasks — writing features, fixing bugs, and answering questions about your codebase — and it can run shell commands and MCP tools like Postiz.

💻

Terminal & IDE Native

Claude Code runs in your terminal, with extensions for VS Code and JetBrains. You type what you want in plain English and it handles Postiz for you.

🔧

Agentic Execution

Claude Code plans and works through multi-step tasks on its own — discovering channels, uploading media, and scheduling posts — and asks for permission before it acts.

⚡

Parallel Tasks

Run several Claude Code sessions side by side, or spawn subagents in one. Schedule posts to different platforms while it handles other coding work.

How Postiz Works with Claude Code

Claude Code discovers Postiz through the Postiz skill or the Postiz MCP server. It reads the SKILL.md (or the MCP tool list) to learn what it can do, then chains calls together for social media workflows.

✓Install the Postiz skill, or add the Postiz MCP server with claude mcp add
✓Claude Code reads the SKILL.md and learns all Postiz commands
✓POSTIZ_API_KEY must be set in environment
✓Claude Code asks for permission before running commands
✓Works alongside your coding tasks in parallel

Install Postiz

# Option A: add the Postiz MCP server
claude mcp add --transport http postiz https://mcp.postiz.com/mcp-oauth-dynamic

# Option B: install the Postiz skill
npx skills add gitroomhq/postiz-agent
export POSTIZ_API_KEY=your_api_key

# Then just ask
claude "list my social media integrations"

Reddit Posting with Claude Code

Tell Claude Code what to post from your terminal or IDE — it discovers your integrations via Postiz and handles the entire publishing workflow.

💻

Just Ask Claude Code

Terminal and IDE integration

Tell Claude Code what to post from your terminal or IDE — it discovers your integrations via Postiz and handles the entire publishing workflow.

Claude Code CLI

$ claude "Post to Reddit about our
  new feature launch, schedule for
  tomorrow at 9am"

Claude Code: I'll handle that.
  Found your Reddit integration.
  Composing and scheduling the post.

  Done! Your post is scheduled.
  Post ID: abc-123

💻

Parallel Tasks

Multiple tasks at once

Claude Code runs headless with claude -p, so several tasks can run in parallel. Schedule posts to different platforms while it works on other coding tasks.

Claude Code Parallel Tasks

# Run multiple posting tasks in parallel
$ claude -p "Schedule a post about our
  launch to X for tomorrow 9am" &

$ claude -p "Write a LinkedIn article
  about our new feature and schedule
  for tomorrow noon" &

$ claude -p "Fix the bug in auth.ts"

# All three tasks run simultaneously

Why Claude Code + Postiz for Reddit

Claude Code's autonomous execution makes Postiz a natural fit. The agent reads the SKILL.md to understand every available command, then autonomously chains them together for Reddit workflows.

✓Runs in your terminal or IDE — just type what you want
✓Permission-based execution — you stay in control
✓Parallel task support — post while coding
✓Reads SKILL.md for automatic command discovery
✓Cross-post to Reddit + other platforms in a single session
✓Powered by Claude — Anthropic's most capable models

SKILL.md (auto-discovered)

---
name: postiz
description: Social media automation
  CLI for scheduling posts across
  30+ platforms including Reddit
metadata:
  claude-code:
    requirements:
      env:
        - POSTIZ_API_KEY
      binaries:
        - postiz
---

# Available Commands
- postiz integrations:list
- postiz integrations:settings <id>
- postiz integrations:trigger <id>
    getFlairs -d '{"subreddit":"..."}'
- postiz posts:create
- postiz upload <file>
- postiz analytics:platform <id>

# Reddit Settings
subreddit (array of targets),
type (self/link/image/video),
title, url, flair, is_flair_required

Also Works with Claude Cowork

Postiz works with any AI agent that can run commands or call MCP tools — you ask, the agent does the work. That includes Claude Cowork, Anthropic's desktop agent — no terminal needed.

Claude Cowork

by Anthropic

Claude Cowork reads the Postiz skill so it knows what it can do, then autonomously discovers your Reddit integration, checks flair requirements, and schedules posts to the right subreddits.

Claude Cowork

> Post to r/programming and r/webdev
  about our new feature, schedule for
  tomorrow morning

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

Reddit + Other Platforms

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

Example

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

Claude Code: Done! Scheduled:
  - Reddit + LinkedIn: tomorrow 9:00 AM
  - Daily tips on Reddit: Mon-Fri 10:00 AM

Start posting to Reddit

Install Postiz Agent and automate your Reddit content strategy with AI-powered scheduling and publishing.

Get Started

Ready to get started?

Grow your social media presence with Postiz.
Schedule, analyze, and engage with your audience.

Start for $0

Open-source social media scheduling tool

Proudly open-source ❤️