Post to Instagram from Claude Code

Claude Code can schedule and publish Instagram posts through Postiz. After you add the Postiz MCP server and sign in, ask Claude Code to post an image from your repo to the feed, publish a story, run a trial reel, or tag collaborators. Postiz uploads the media and publishes at the time you set.

Setup Guide GitHub

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

Last updated: September 2026

How to post to Instagram from Claude Code

Add the Postiz MCP server to Claude Code once, sign in with OAuth, connect Instagram 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 ./assets/launch.png to Instagram with
  a caption about the v2.4 launch, tomorrow
  at 6pm

Claude Code: Done! Your Instagram feed post
  is scheduled for tomorrow at 6:00 PM.

What can Claude Code do on Instagram?

On Instagram, Claude Code can publish feed posts and stories, mark a video as a trial reel, choose how the reel graduates, and add collaborators to a post.

📷

Feed Posts

Publish photo and video posts to your Instagram feed with captions, hashtags, and location tags. Schedule for optimal engagement times.

📱

Stories

Share ephemeral content with Instagram Stories. Upload images or videos that disappear after 24 hours.

🎬

Trial Reels

Test content with trial reels that have limited initial reach. Graduate to full distribution manually or automatically based on performance.

🤝

Collaborator Tags

Tag collaborators on your posts to co-author content. The post appears on both profiles, doubling your reach.

📊

Graduation Strategy

Control how trial reels graduate to full reach. Choose MANUAL for hands-on control or SS_PERFORMANCE for automatic promotion.

📅

Scheduled Posting

Schedule posts and stories with precise timestamps. Plan your Instagram content calendar and let Postiz handle the publishing.

How does Claude Code post to Instagram 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 Instagram Integration

Ask Claude Code whether your Instagram account is connected. It also checks which options the platform supports.

Example conversation

> Is my Instagram account connected to Postiz?

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

Upload Your Media

Upload your photo or video to get a public URL. Instagram requires media to be accessible via HTTPS. Supports JPG, PNG, MP4, and more.

Example conversation

> Draft a Instagram post about our new
  feature launch

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

Create Your Post

Schedule an Instagram post with your media, caption, hashtags, and platform-specific settings like post type, trial reels, and collaborators.

Example conversation

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

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

Instagram Settings Reference

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

Field	Type	Required	Description
`__type`	string	Yes	Must be "instagram" or "instagram-standalone"
`post_type`	string	Yes	Content type: "post" (feed) or "story"
`is_trial_reel`	boolean	No	Post as a trial reel with limited initial reach
`graduation_strategy`	string	No	Trial reel graduation: "MANUAL" or "SS_PERFORMANCE" (auto based on performance)
`collaborators`	array	No	List of collaborator objects, e.g. [{"label":"username"}]

Common Configurations

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

Simple Feed Post

Just ask

> Post it with: Simple Feed Post

Claude Code: Got it. Applying:
  post_type: post

Story Post

Just ask

> Post it with: Story Post

Claude Code: Got it. Applying:
  post_type: story

Trial Reel with Auto Graduation

Just ask

> Post it with: Trial Reel with Auto Graduation

Claude Code: Got it. Applying:
  post_type: post
  is_trial_reel: yes
  graduation_strategy: SS_PERFORMANCE

Collaborator Post

Just ask

> Post it with: Collaborator Post

Claude Code: Got it. Applying:
  post_type: post
  collaborators: cofounder, designer_jane

Example prompts for Instagram 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.

Feed post from a repo asset

Claude Code

> Post ./marketing/dark-mode.png to Instagram
  with a 3-line caption and 5 relevant
  hashtags, Saturday 11am

Claude Code: Uploaded dark-mode.png. Scheduled
  on Instagram (post_type: post) for
  Saturday 11:00 AM.

Story instead of feed

Claude Code

> Publish ./assets/behind-the-scenes.mp4 as an
  Instagram story right now

Claude Code: Publishing to Instagram with
  post_type: story. Done.

Trial reel with collaborators

Claude Code

> Post ./clips/demo.mp4 as a trial reel on
  Instagram, graduate it automatically based on
  performance, and add @designpartner as a
  collaborator

Claude Code: Set is_trial_reel: true,
  graduation_strategy: SS_PERFORMANCE,
  collaborators: [designpartner]. Scheduled.

Instagram limits and gotchas to know

Instagram is media first, so a few constraints shape how you ask Claude Code to post.

✓Every Instagram post needs an image or video. A text-only request fails, so point Claude Code at a file or URL.
✓post_type is required and must be post (feed) or story. Say story explicitly when you want one.
✓Instagram captions are limited to 2,200 characters; Claude Code keeps captions under that when it drafts them.
✓Trial reels use is_trial_reel and graduation_strategy (MANUAL or SS_PERFORMANCE). Ask for automatic graduation if you want Instagram to promote it based on performance.
✓Collaborators are passed as usernames, and the tagged account still has to accept the invite in Instagram.

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 Instagram 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"

Instagram 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 Instagram about our
  new feature launch, schedule for
  tomorrow at 9am"

Claude Code: I'll handle that.
  Found your Instagram 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 Instagram

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 Instagram 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
✓Trial reels and graduation strategies applied automatically
✓Cross-post to Instagram + 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 Instagram
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>

# Instagram Settings
post_type, is_trial_reel,
graduation_strategy,
collaborators

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 Instagram integration, uploads your photo, applies post type and collaborator settings, and schedules the post.

Claude Cowork

> Post my product photo to Instagram
  as a feed post with collaborator tags,
  schedule for tomorrow evening

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

Post to Instagram and other platforms from Claude Code

One request can schedule the same content to Instagram 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
  Instagram and Facebook tomorrow at 9am, then schedule
  a daily tip on Instagram every weekday at 10am

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

Post to TikTok from Claude Code→Post to Facebook from Claude Code→Post to Pinterest from Claude Code→Post to YouTube from Claude Code→Post to LinkedIn 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, seeInstagram scheduling features in Postiz.

Post Types

Feed Post

post

Story

story

Instagram and Claude Code: frequently asked questions

How do I post to Instagram from Claude Code?

Add the Postiz MCP server to Claude Code with one command, sign in to Postiz with OAuth, and connect your Instagram account in Postiz. Then ask Claude Code to post a specific image or video with a caption and a time. It uploads the file through Postiz, sets post_type, and schedules the post.

Can Claude Code post Instagram stories?

Yes. Ask for a story and Claude Code sets post_type to story instead of post. Give it an image or a short video from your repo or a URL, and Postiz publishes it as a story at the time you choose. Feed posts and stories can be scheduled in the same session.

What is a trial reel and can Claude Code publish one?

A trial reel is an Instagram reel shown first to people who do not follow you, so you can test it before it reaches your audience. Claude Code sets is_trial_reel to true and graduation_strategy to MANUAL or SS_PERFORMANCE, the latter letting Instagram promote the reel automatically when it performs well.

Can Claude Code generate the image for an Instagram post?

Yes, when you connect through the custom Postiz MCP link rather than the Claude.ai directory connector. The MCP server includes image and video generation and clipping tools, so you can ask Claude Code to generate a cover image and post it to Instagram in one request. The directory connector does not include those tools.

Can I schedule Instagram posts from Claude Code without an interactive session?

Yes. Claude Code's headless mode, claude -p, runs a single prompt from a script or CI job and exits. Point it at a media file that exists on that machine, ask it to schedule the Instagram post through Postiz, and it publishes at the requested time with no terminal session open.

Start posting to Instagram

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

Get Started