doodle top mobile

Run Your Social Media from Claude Code

Postiz plugs into Claude Code, Anthropic's agentic coding tool. Add the Postiz MCP server with one command, or install the Postiz skill, and Claude Code can schedule, publish, and manage your posts across 30+ platforms — autonomously, from the terminal, right alongside your code.

View Docs

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

doodle left mobiledoodle right mobile

Install Postiz for Claude Code

Add the Postiz MCP server with one command, or install the Postiz skill in your project. Takes under a minute.

Postiz MCP server

Recommended. One command, sign in to Postiz in the browser, and you get the full toolset — posting, scheduling, analytics, plus image and video generation and clipping.

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

Prefer the CLI skill, or want to add the server by hand? Use the options below.

From the skills CLI

npx skills add gitroomhq/postiz-agent

Postiz MCP link (for .mcp.json)

https://mcp.postiz.com/mcp-oauth-dynamic

Then just ask

# If you installed the skill, set your API key
export POSTIZ_API_KEY=your_api_key

# Start Claude Code and ask
$ claude
> List my connected social media accounts
> Post "Hello from Postiz!" to X and LinkedIn,
  schedule it for tomorrow at 9am

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

Built for Automation

🤖

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.

💻

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

Post From Your Terminal

Tell Claude Code what to post — it discovers your integrations through Postiz, uploads media, and handles the entire posting workflow 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 You Can Ask

A few things you can say to Claude Code. It handles the Postiz calls behind the scenes.

You sayWhat happens
Which accounts do I have connected?Lists every connected social channel
What options does my Reddit channel support?Shows platform-specific settings like flairs or playlists
What flairs are available in r/programming?Fetches live platform data before posting
Post this to X and LinkedIn tomorrow at 9amCreates and schedules a post across channels
Turn README.md into a 5-tweet launch threadReads your repo and drafts platform-native content
What's scheduled for this week?Lists scheduled and published posts
Cancel tomorrow's LinkedIn postDeletes a scheduled post
How did my X account do last month?Pulls channel analytics for any period
Generate a cover image for this postCreates media with the MCP server's image tools
Upload cover.png so I can reuse it laterUploads media and keeps it ready for future posts

Frequently Asked Questions

What is Claude Code?

Claude Code is Anthropic's agentic coding tool that lives in your terminal (with extensions for VS Code and JetBrains). It reads your codebase, runs commands, calls MCP tools, and completes multi-step tasks autonomously — including scheduling and publishing your social media through Postiz.

How do I connect Postiz to Claude Code?

The fastest way is one terminal command: “claude mcp add --transport http postiz https://mcp.postiz.com/mcp-oauth-dynamic”. Claude Code opens a browser tab to sign in to Postiz and you're connected — no API key needed. Alternatively, run “npx skills add gitroomhq/postiz-agent” in your project and set POSTIZ_API_KEY, and Claude Code picks up the Postiz skill automatically.

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?

Draft, schedule, and publish posts, upload images and videos, create threads and comments, apply platform-specific settings like Reddit flairs or YouTube playlists, pull analytics, and plan whole content calendars — across 30+ platforms, right from your terminal.

Can I automate it without an interactive session?

Yes. Claude Code has a headless mode (claude -p "...") that runs a single prompt and exits. Use it in shell scripts, cron jobs, or CI — for example, a GitHub Action that asks Claude Code to announce every new release on X and LinkedIn through Postiz.

Which social media platforms are supported?

30+ platforms, including X (Twitter), LinkedIn, Instagram, Facebook, Reddit, YouTube, TikTok, Pinterest, Discord, Slack, Telegram, Threads, Bluesky, Mastodon, and more.

Does it work with other AI agents?

Yes. Postiz works with any agent that can run commands or call MCP tools — including Claude Cowork, Cursor, Codex, and ChatGPT. You just ask; the agent does the work.

Is it free to start?

Yes. You can create a Postiz account for free, connect your channels, and start posting with Claude Code right away.

Using Claude in the browser or on desktop instead? See the Claude and Claude Cowork guides. 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.