Post to Instagram from Claude Code

Reels, Trial Reels, Stories and carousels, from your terminal. Here are the settings it sets and the limits it works within.

$ claude mcp add sharek --transport http "https://dash.sharek.app/mcp-oauth-dynamic"
~/skincare-launch
$claude mcp add sharek --transport http "https://dash.sharek.app/mcp-oauth-dynamic"
Added HTTP MCP server sharek with URL: https://dash.sharek.app/mcp-oauth-dynamic to local config
$claude
>Schedule the newest video in my media library as a Trial Reel on Zahra'sInstagram, Thursday at 18:00. I'll share it with followers myself.
sharek integrationListinstagram: Zahra Skincare
sharek integrationSchemainstagram
sharek mediaListTool1 video
sharek integrationSchedulePostTool1 post
settings: {"post_type":"post","is_trial_reel":true,"graduation_strategy":"MANUAL"}
✓Scheduled for Thursday at 18:00 as a Trial Reel.

What are the Instagram settings?

These are the fields Sharek accepts on an Instagram post, read from the app's code. Claude Code gets them from integrationSchema and fills them in from your request, so you never type them.

FieldTypeRequiredAcceptsWhat it does
post_typestringRequiredpoststorypost publishes to the feed: one photo is a post, several items are a carousel, one video is a Reel. story publishes a Story.
is_trial_reelbooleanOptionaltruefalseShows the Reel to non-followers first. Needs exactly one video.
graduation_strategystringOptionalMANUALSS_PERFORMANCEHow a Trial Reel reaches your followers: MANUAL when you share it by hand, SS_PERFORMANCE based on how it performs. If you leave it out, Sharek sends MANUAL.
collaboratorsarrayOptional[{ "label": "username" }]Accounts to invite as collaborators. Not used on Stories.
audioobjectOptional{ "id": "...", "audio_volume": 80, "video_volume": 20 }A track for a Reel. Works on a single video, on the Facebook Business connection only.

Inside collaborators and audio

collaborators[]

FieldTypeRequiredAcceptsWhat it does
labelstringRequiredstringThe Instagram username. A leading @ is removed for you.

audio

FieldTypeRequiredAcceptsWhat it does
idstringRequiredstringThe track's id, from the audioSearch helper.
titlestringOptionalstringTrack title.
artiststringOptionalstringTrack artist.
imagestringOptionalstringCover image for the track.
audio_volumenumberOptional0 to 100Volume of the track.
video_volumenumberOptional0 to 100Volume of the video's own sound.

Which Instagram connection do you have?

Instagram (Facebook Business)
instagram

A business account linked to a Facebook Page. All five settings work, including audio.

Instagram (Standalone)
instagram-standalone

A professional account, no Page needed. Same settings, without the audio helper.

Which prompt sets which settings?

Six real configurations. Copy a prompt, and this is what goes into the post's settings.

Feed post or carousel

Post the three newest photos in my media library to Instagram as one carousel, Tuesday at 09:00.

Applying
{
  "post_type": "post"
}

Story

Schedule the newest picture in my media library as an Instagram Story for Friday at 17:00.

Applying
{
  "post_type": "story"
}

Trial Reel, shared by hand

Schedule the newest video in my media library as a Trial Reel for Thursday at 18:00. I will share it with followers myself.

Applying
{
  "post_type": "post",
  "is_trial_reel": true,
  "graduation_strategy": "MANUAL"
}

Trial Reel, shared by performance

Make that video a Trial Reel and let its performance decide whether it reaches my followers.

Applying
{
  "post_type": "post",
  "is_trial_reel": true,
  "graduation_strategy": "SS_PERFORMANCE"
}

With collaborators

Post this photo to Instagram on Monday at 10:00 and invite @sahelresorts and @noorstudio as collaborators.

Applying
{
  "post_type": "post",
  "collaborators": [
    {
      "label": "sahelresorts"
    },
    {
      "label": "noorstudio"
    }
  ]
}

Reel with a track

Find a trending track and add it to this Reel, with the music at 80 and the video's own sound at 20.

Applying
{
  "post_type": "post",
  "audio": {
    "id": "track-id-from-audioSearch",
    "audio_volume": 80,
    "video_volume": 20
  }
}

triggerTool → audioSearch

What are the limits on Instagram?

These come from Sharek's code and the channel's rules. Knowing them saves you a failed post.

  • Every post needs at least one photo or video. A text-only post is refused.
  • A caption can be up to 2,200 characters.
  • A carousel takes up to 10 items. Sharek enforces this on the Facebook Business connection.
  • A Story takes one picture, so ask for one Story per picture.
  • A Trial Reel must be one video, not several items and not a photo.
  • Audio works on a single-video Reel, never on a Story, and only on the Facebook Business connection.
  • Collaborators: up to 3 public accounts, never on a Story.
  • Alt text can be up to 1,000 characters, on photos only. It's set on the attachment, not in settings.
  • Media must live in Sharek first. Over MCP, it comes from a public link or your media library. A file on your computer goes through sharek upload.
  • Sharek doesn't crop or resize. Export the right size first.
  • Tagging people and product tags aren't available from Sharek.

How does Claude Code post to Instagram?

It lists your channels to find the Instagram one, reads that channel's settings, picks the media, then creates the post. You connect once, with the command at the top of this page.

  1. integrationList
  2. integrationSchema
  3. mediaListTool
  4. integrationSchedulePostTool

How do I post a file from my repo?

Over MCP, media comes from a public link or your media library. For a file on your computer, use the CLI: upload it, then attach the path it returns. Settings go in as JSON.

terminal
URL=$(sharek upload ./reel.mp4 | tail -n +2 | jq -r '.path')
sharek posts:create -c "A gentle serum for every day." -m "$URL" \
  -s "2027-01-14T15:00:00Z" -i "channel-id" \
  --settings '{"post_type":"post","is_trial_reel":true,"graduation_strategy":"MANUAL"}'

What else can I ask?

Read the release notes in CHANGELOG.md and write an Instagram caption for the newest video in my media library. Schedule it for Tuesday at 18:00.

List my Instagram posts scheduled this month and tell me which ones have no collaborators.

Turn Thursday's Instagram Reel into a Trial Reel, and let its performance decide whether it reaches my followers.

Questions, answered

Connect once with claude mcp add sharek --transport http "https://dash.sharek.app/mcp-oauth-dynamic" and sign in with /mcp. Then ask for the post. Claude Code reads the channel's settings and sets post_type for you.
Yes. With post_type set to post, one video publishes as a Reel and several items as a carousel. With post_type set to story, the picture publishes as a Story.
Ask for a Trial Reel. Claude Code sets is_trial_reel to true and graduation_strategy to MANUAL or SS_PERFORMANCE, depending on whether you'll share it yourself. It needs exactly one video.
Not over MCP, where media comes from a public link or your media library. With the CLI, sharek upload puts the file in Sharek and returns the path to attach.
Yes, on a single-video Reel over the Facebook Business connection. Claude Code finds tracks with the audioSearch helper through triggerTool. The Standalone connection doesn't offer it.
No. Sharek doesn't offer tagging people or product tags. Add those in Instagram after the post goes out. You can invite up to 3 public accounts as collaborators.
Not always. The Standalone connection needs a professional account and no Page. The Facebook Business connection needs a business account linked to a Facebook Page.

Schedule your next Reel from the terminal

Start a 7-day free trial, connect your Instagram account and run the command. We collect a card at checkout, and you can cancel from settings.

Start free trial