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"integrationListinstagram: Zahra SkincareintegrationSchemainstagrammediaListTool1 videointegrationSchedulePostTool1 postWhat 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.
| Field | Type | Required | Accepts | What it does |
|---|---|---|---|---|
post_type | string | Required | poststory | post 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_reel | boolean | Optional | truefalse | Shows the Reel to non-followers first. Needs exactly one video. |
graduation_strategy | string | Optional | MANUALSS_PERFORMANCE | How 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. |
collaborators | array | Optional | [{ "label": "username" }] | Accounts to invite as collaborators. Not used on Stories. |
audio | object | Optional | { "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[]
| Field | Type | Required | Accepts | What it does |
|---|---|---|---|---|
label | string | Required | string | The Instagram username. A leading @ is removed for you. |
audio
| Field | Type | Required | Accepts | What it does |
|---|---|---|---|---|
id | string | Required | string | The track's id, from the audioSearch helper. |
title | string | Optional | string | Track title. |
artist | string | Optional | string | Track artist. |
image | string | Optional | string | Cover image for the track. |
audio_volume | number | Optional | 0 to 100 | Volume of the track. |
video_volume | number | Optional | 0 to 100 | Volume of the video's own sound. |
Which Instagram connection do you have?
instagramA business account linked to a Facebook Page. All five settings work, including audio.
instagram-standaloneA 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.
{
"post_type": "post"
}Story
Schedule the newest picture in my media library as an Instagram Story for Friday at 17:00.
{
"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.
{
"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.
{
"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.
{
"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.
{
"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.
integrationListintegrationSchemamediaListToolintegrationSchedulePostTool
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.
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
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
