logo
Claude CodeClaude Code + Postiz

Schedule Social Media Posts with Claude Code

  • One terminal command adds Postiz to Claude Code
  • Draft, schedule and manage posts on 30+ platforms
  • Reads your repo, asks permission, runs headless in CI
Start for $0

Postiz is the agentic social media scheduling platform that Claude Code drives through an MCP server and the Postiz CLI. Please make sure there is always a human in the loop. Last updated: September 2026. Part of the Postiz AI agents guide.

How to install Postiz in Claude Code

The fastest way is one terminal command that registers the Postiz MCP server and signs you in with OAuth. The Postiz skill is the alternative for projects that prefer a CLI. Either way takes under a minute.

1Install
under a minute

Run this in your terminal

One command registers the Postiz MCP server. Claude Code opens a browser tab, you sign in to Postiz, and the full toolset is ready.

terminal
claude mcp add --transport http postiz https://mcp.postiz.com/mcp-oauth-dynamic

Recommended. Sign in to Postiz in the browser and you get posting, scheduling, analytics, plus image and video generation and clipping. No API key. Prefer the CLI skill? Run npx skills add gitroomhq/postiz-agent and set POSTIZ_API_KEY. Details in the Postiz MCP docs.

2Ask
live in Postiz

Ask Claude Code to post for you

Type the request in a Claude Code session. It reads your repo for the copy, asks for permission, then schedules through Postiz.

Read CHANGELOG.md and post a thread about v2.4 on X and LinkedIn with ./assets/release.png, tomorrow at 9am.

Claude Code

Read CHANGELOG.md and uploaded release.png. Scheduled via Postiz: X, 5-tweet thread at 9:00 AM tomorrow; LinkedIn, single post at 9:00 AM. Both include the image.

via PostizXLinkedin

Also try

List my connected channelsTurn README.md into a launch threadWhat's scheduled for this week?
  1. 1Run claude mcp add --transport http postiz https://mcp.postiz.com/mcp-oauth-dynamic in your terminal
  2. 2Claude Code opens a browser tab. Sign in to Postiz and approve access, no API key needed
  3. 3Start claude and ask it to post. Claude Code asks for permission, then schedules through Postiz
  4. 4Prefer the CLI skill? Run npx skills add gitroomhq/postiz-agent and export POSTIZ_API_KEY instead

One terminal command powers every channel you run

Connect your accounts in Postiz once. From then on Claude Code can post to any of them from your terminal, and Postiz publishes at the time you set.

Claude Code
XLinkedInInstagramFacebookThreadsRedditYouTubeTikTokPinterestBlueskyDiscordSlackGoogle BusinessTelegramMastodonDribbbleWordPressMediumHashnodeDev.toTwitchKickWarpcastNostrLemmyVKMeWeWhopSkoolListmonk

Which way should I connect Postiz to Claude Code?

Use the custom MCP link unless you have a reason not to. It is the only route with the full toolset, and it needs no API key. The table compares all three options.

MethodHow you connectAuthAPI keyToolsetBest for
Postiz MCP server (custom link)claude mcp add --transport http postiz https://mcp.postiz.com/mcp-oauth-dynamicOAuth sign-in in the browserNoFull: posting, scheduling, analytics, image and video generation, clippingMost Claude Code users
Official connector from the Claude directoryConnect Postiz in Claude.ai, then sign in to Claude Code with the same accountOAuth via Claude.aiNoPosting, scheduling, analytics (no image, video, or clipping tools)People already using Postiz in Claude.ai
Postiz skill (CLI)npx skills add gitroomhq/postiz-agentPOSTIZ_API_KEY in your environmentYesPostiz CLI commands described in SKILL.mdProjects that prefer a CLI or cannot use MCP

The same MCP server works with other agents too. See the Postiz MCP server page and the AI agents overview.

Why use Claude Code for social media automation?

Claude Code already knows your codebase, so release notes, docs, and screenshots become posts without copy-pasting. Postiz gives it structured tools for every platform, so one prompt can cover a whole campaign.

AI Agent Ready

Postiz returns structured results, so Claude Code 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, Claude Code 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. With the MCP server, Claude Code can also generate images and videos and clip long videos into shorts.

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.

What is Claude Code?

Claude Code is Anthropic's agentic coding tool. It lives in your terminal, understands your codebase, runs commands, calls MCP tools, and takes real actions on your behalf — including managing your social media with Postiz.

Claude Code vs Claude Cowork vs the Claude.ai connector

All three are Anthropic products that can drive Postiz, but they run in different places and suit different people. This page is about Claude Code.

SurfaceWhere it runsWho it is forHow Postiz connectsNotable difference
Claude CodeTerminal, VS Code, JetBrainsDevelopersclaude mcp add ... or the Postiz skillReads your repo, headless mode (claude -p), CI and cron
Claude CoworkDesktop appKnowledge workersPostiz skill or MCP connector, no terminalWorks with local files and desktop apps
Claude.ai connectorBrowser, desktop, mobile chatAnyone on Claude.aiOfficial directory connector or custom MCP linkDirectory version lacks image, video, and clipping tools

Terminal Native

Talk to Claude Code right where you work. Run it in any terminal, or inside VS Code and JetBrains, and manage your socials next to your code.

Skills & MCP

Claude Code extends its abilities through skills and the Model Context Protocol. Postiz works as a skill or as an MCP server — connect once and go.

Headless & Scriptable

Run a single prompt with claude -p and exit. Put Postiz posting in shell scripts, cron jobs, or CI pipelines — announce every release automatically.

How Postiz Works with Claude Code

Add Postiz as an MCP server and Claude Code sees every Postiz tool — channels, posts, media, analytics — the moment you sign in. Or install the Postiz skill in your project and Claude Code reads the bundled SKILL.md to learn the CLI commands and how to compose posts for each platform.

  • One command: claude mcp add --transport http postiz <link>
  • Sign in to Postiz in the browser — no API key to manage
  • Or install the skill: npx skills add gitroomhq/postiz-agent
  • Claude Code asks for permission before it acts
  • Works with Claude.ai, Console, Bedrock, and Vertex AI accounts
Install in Claude Code
# 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

# Verify it
$ claude "List my social media integrations"

# Claude Code replies with your connected
# channels — you are ready to post

How do I post to social media from the terminal with Claude Code?

Type the request in a Claude Code session, or pass it to claude -p in a script. Claude Code discovers your channels through Postiz, uploads media, applies platform settings, and schedules the posts while you keep coding.

Just Ask

One prompt, full automation

Type a prompt in your Claude Code session. It finds your accounts via Postiz, uploads media, and schedules posts — and it can read the files in your repo to write the copy.

Claude Code
> Read CHANGELOG.md and post a thread about
  v2.4 on X and LinkedIn with
  ./assets/release.png, tomorrow at 9am

Claude Code: Done! Posts scheduled:
  - X (Twitter): 5-tweet thread, 9:00 AM
  - LinkedIn: single post, 9:00 AM
  Both include release.png

Headless & CI

Scripts, cron, and GitHub Actions

Run Claude Code non-interactively with a single prompt. Wire it into a release pipeline or a nightly job and Postiz posts without anyone opening a terminal.

release.sh
#!/bin/bash
# Runs after a new tag is pushed

claude -p "Summarize the changes since the
  last git tag and schedule a launch post
  on X, LinkedIn, and r/programming via
  Postiz for today at 10am. Attach
  ./assets/release.png."

# Claude Code reads the git history,
# writes the copy, and schedules via Postiz

Why Claude Code + Postiz

  • Every tool returns structured results Claude Code can act on
  • MCP server or CLI skill — pick whichever fits your setup
  • Full toolset over MCP: image and video generation, clipping
  • Platform-specific options (flairs, playlists, boards) are queryable live
  • Headless mode turns any script or CI job into a publisher
  • Permission prompts keep a human in the loop
SKILL.md (auto-discovered)
---
name: postiz
description: Social media automation
  CLI for scheduling posts across
  30+ platforms
metadata:
  claude-code:
    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>

What can you ask Claude Code to do in Postiz?

Anything the Postiz tools expose: channels, posts, media, settings, and analytics. Here are typical requests and what Claude Code does with each one.

Launch

Turn your README into a thread

Turn README.md into a 5-tweet launch thread and schedule it on X for tomorrow at 9am.

Release notes

Post a changelog with media

Read CHANGELOG.md and post about v2.4 on X and LinkedIn with ./assets/release.png, tomorrow at 9am.

Community

Check flairs, then post

What flairs are available in r/programming? Pick the right one and post the release there, then drop the link in Discord.

Analytics

Review the calendar

What's scheduled for this week, and how did my X account do last month?

Which platforms can Claude Code post to?

Postiz supports 30+ channels, and these 25 have a dedicated Claude Code guide with example prompts, a settings reference, platform-specific limits, and a FAQ. Connect once in Postiz and post everywhere.

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

Frequently Asked Questions

What is Claude Code?

Claude Code is Anthropic's agentic coding tool. It runs in your terminal, with extensions for VS Code and JetBrains, reads your codebase, runs commands, and calls MCP tools to finish multi-step tasks. Connected to Postiz, it can also draft, schedule, and publish social media posts across 30+ platforms from the same session.

How do I connect Postiz to Claude Code?

Run claude mcp add --transport http postiz https://mcp.postiz.com/mcp-oauth-dynamic in your terminal. Claude Code opens a browser tab where you sign in to Postiz, and the connection is done with no API key. Alternatively, run npx skills add gitroomhq/postiz-agent in your project and set POSTIZ_API_KEY so Claude Code picks up the Postiz skill.

Is Claude Code the same as Claude Cowork or the Claude.ai connector?

No. Claude Code is the terminal and IDE agent for developers. Claude Cowork is Anthropic's desktop agent for knowledge workers and needs no terminal. The Claude.ai connector adds Postiz to the Claude chat app in the browser, desktop, or mobile. All three can use Postiz, and this page covers Claude Code only.

Does the official Postiz connector from the Claude directory work in Claude Code?

Yes. If you connected Postiz in Claude.ai, it is available in Claude Code when you sign in with the same account. The directory version covers posting, scheduling, and analytics. To also get image generation, video generation, and clipping, add the custom MCP link with claude mcp add. Everything else works the same.

What can Claude Code do with Postiz?

It can list your connected channels, draft posts from files in your repo, upload images and videos, create threads and comments, apply platform settings such as Reddit flairs or YouTube visibility, schedule or cancel posts, pull analytics, and plan a content calendar. Over the custom MCP link it can also generate images and videos and clip long videos.

Can I automate posting without an interactive Claude Code session?

Yes. Claude Code's headless mode, claude -p "...", runs a single prompt and exits. Put it in a shell script, cron job, or GitHub Action, for example asking Claude Code to summarize changes since the last git tag and schedule a launch post on X and LinkedIn through Postiz. The MCP server or skill must be configured on that machine.

Do I need an API key to use Postiz with Claude Code?

Not with the MCP route. The Postiz MCP server uses OAuth, so you sign in once in the browser and Claude Code stores the connection. No Postiz key and no social network developer keys are involved. The skill route is the exception: the Postiz CLI it installs reads POSTIZ_API_KEY from your environment.

Claude Code does not see the Postiz tools. What should I check?

First run claude mcp list to confirm the postiz server is registered; if not, rerun the claude mcp add command. Then start a new Claude Code session, since servers are loaded at startup, and complete the OAuth sign-in when the browser opens. If you use the skill instead, check that POSTIZ_API_KEY is exported in the shell that starts Claude Code.

Which social media platforms can Claude Code post to?

Postiz supports 30+ channels, including X, LinkedIn, Instagram, Facebook, Reddit, YouTube, TikTok, Pinterest, Discord, Slack, Telegram, Threads, Bluesky, and Mastodon. This site has a dedicated Claude Code guide for 25 of them, each with example prompts, the platform's settings reference, and platform-specific limits. Follow the links in the platforms section above.

Is it free to start?

Postiz offers a 7-day free trial, and paid plans start at $29 per month. Claude Code itself is billed by Anthropic under your Claude plan or API account. Connect Postiz to Claude Code during the trial, test a few posts, then pick a plan on the pricing page.

Using Claude in the browser or on desktop instead? See the Claude and Claude Cowork guides, the AI agents overview, the Postiz MCP server page, and pricing. Claude Code is open source on GitHub.

Start automating today

Connect Postiz to Claude Code once and let it handle social media posting across every platform from your terminal.