Post to Reddit from Claude Code

Claude Code can publish and schedule Reddit posts through Postiz. Add the Postiz MCP server with one command, sign in with OAuth, and ask Claude Code to post to r/programming with a specific flair, submit a link post, or cross-post the same content to several subreddits, each with its own title and settings.

Setup Guide GitHub

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

Last updated: September 2026

How to post to Reddit from Claude Code

Add the Postiz MCP server to Claude Code once, sign in with OAuth, connect Reddit in Postiz, and then describe the post in plain language. Setup takes about a minute.

Setup once, then just ask

# One-time setup: add the Postiz MCP server (OAuth, no API key)
claude mcp add --transport http postiz https://mcp.postiz.com/mcp-oauth-dynamic

# Or install the Postiz skill instead
npx skills add gitroomhq/postiz-agent
export POSTIZ_API_KEY=your_api_key

# Then ask Claude Code:
> Post our tutorial to r/programming with the
  "Tutorial" flair, tomorrow at 9am

Claude Code: Done! Reddit post scheduled on
  r/programming with flair "Tutorial" for
  tomorrow at 9:00 AM.

What can Claude Code do on Reddit?

On Reddit, Claude Code can create self, link, image, and video posts, look up the flairs a subreddit offers, and target several subreddits in one request.

🎯

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 does Claude Code post to Reddit through Postiz?

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 AI scheduling 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 AI social media scheduler', 'type': 'self', 'is_flair_required': False}, {'subreddit': 'artificial', 'title': 'We just launched our AI social media scheduler', 'type': 'link', 'url': 'https://example.com/launch', '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'}}

Example prompts for Reddit in Claude Code

These are prompts you can type into a Claude Code session, or pass to claude -p in a script. Claude Code reads your repo, calls Postiz, and confirms before publishing.

Check flairs before posting

Claude Code

> What flairs does r/SaaS require? Then
  post our v2.4 release there as a link post
  to the GitHub release with the right flair

Claude Code: r/SaaS requires a flair.
  Options: Release, Question, Guide...
  Using "Release". Scheduled as a link post.

Cross-post to several subreddits

Claude Code

> Post the same announcement to r/artificial,
  r/webdev, and r/SideProject with a title
  tailored to each community, Tuesday 10am

Claude Code: Scheduled 3 Reddit posts, one per
  subreddit, each with its own title.

Text post written from your docs

Claude Code

> Read docs/getting-started.md and post a
  self-post summary to r/programming titled
  "How we cut our build time in half"

Claude Code: Created a self post with that
  title. Waiting for your approval to publish.

Reddit limits and gotchas to know

Reddit is strict about titles, post types, and flairs, so it helps to know how Claude Code maps your request to Postiz settings.

✓Every Reddit post needs a title (up to 300 characters) and a type: self, link, image, or video.
✓Some subreddits require a flair. Claude Code can fetch the available flairs live and sets is_flair_required and flair for you.
✓Link posts need a url; write the subreddit name without the r/ prefix in settings (Claude Code handles this when you say r/name).
✓Each subreddit gets its own entry in the subreddit array, so a cross-post can have a different title per community.
✓Subreddit rules still apply. Claude Code asks for permission before it submits anything.

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.

Not the same as Claude Cowork (Anthropic's desktop agent for knowledge workers) or the Postiz connector for Claude.ai (chat in the browser or desktop app). Claude Code runs in your terminal and IDE and can read your repository while it writes Reddit posts.

💻

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 discovers the Postiz tools over MCP, or reads SKILL.md when you use the skill
✓MCP route: sign in with OAuth, no API key. Skill route: set POSTIZ_API_KEY
✓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. That includes Claude Cowork, Anthropic's desktop agent, and the Claude.ai connector. See the agents overview for every supported agent.

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.

Post to Reddit and other platforms from Claude Code

One request can schedule the same content to Reddit and other channels, and each platform keeps its own settings. Every platform below has its own Claude Code guide.

Example

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

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

Post to Lemmy from Claude Code→Post to X from Claude Code→Post to Hashnode from Claude Code→Post to Dev.to from Claude Code→Post to Discord from Claude Code→

See all 25 platforms in the Claude Code social media guide, compare agents on the AI agents overview, read about the Postiz MCP server, or check pricing. For the channel itself, seeReddit scheduling features in Postiz.

Reddit and Claude Code: frequently asked questions

How do I post to Reddit from Claude Code?

Add the Postiz MCP server to Claude Code, sign in to Postiz, and connect your Reddit account in Postiz. Then name the subreddit, the title, and the post type in plain language. Claude Code checks whether the subreddit requires a flair, fills in the Reddit settings, and schedules or publishes the post.

Can Claude Code pick the right Reddit flair automatically?

Yes. Ask what flairs a subreddit offers and Claude Code queries Postiz for the live list. If the subreddit requires one, it sets is_flair_required to true and chooses the flair you name, or suggests one. This avoids the common failure where a post is rejected for a missing flair.

Can Claude Code cross-post to multiple subreddits at once?

Yes. Reddit settings in Postiz accept an array of subreddit targets, each with its own title, type, url, and flair. Ask Claude Code to post to several communities and it fills one entry per subreddit, so you can tailor the title to each audience while keeping one body of content.

Which Reddit post types does Claude Code support through Postiz?

Four types: self (text), link (needs a url), image, and video. Say which you want, or describe it and Claude Code infers it, for example a GitHub release URL becomes a link post. Image and video posts use media that Claude Code uploads through Postiz from a local file or URL.

Can I post release notes to Reddit from a GitHub Action with Claude Code?

Yes. Use headless mode, claude -p, in your release workflow with a prompt such as summarizing the changes since the last tag and posting to r/yoursubreddit through Postiz. Claude Code reads the git history, writes the title and body, sets the flair, and schedules the post before exiting.

Start posting to Reddit

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

Get Started