Claude Code + Instagram

Instagram posts with Claude Code and Bolta

Turn your repo's release notes into social drafts, from the terminal. Parts of the Claude Code route are not confirmed yet, and the note below says which. Nothing goes live on Instagram until you say yes.

Two slash commands, then a browser sign-in. You tick the brands Claude Code may reach.

Claude CodeBolta connected
You

Read the top entry in CHANGELOG.md and draft an Instagram caption for the launch image I attach

Illustration of the reply: Bolta returns a draft showing the connected account and the scheduled time, with Approve, Edit and Reject actions.

Illustration. Your drafts show your real text, account and time.

What is and is not confirmed

Read this before you set up Claude Code

  • Confirmed in Claude Code's official docs: remote HTTP MCP servers with browser sign-in through /mcp, skills as SKILL.md folders, and plugin marketplaces added from a GitHub repo.
  • Bolta's own plugin is the most tested path. A full real-world run on every setup is still beta (plugin v0.5.3).
  • Not confirmed here: the exact minimum Claude Code version for plugin marketplaces (the Bolta plugin README names 2.1.295 or later only as an example), and running Bolta end to end from claude -p in scripts. Claude Code's docs say headless runs cannot do the browser sign-in. The API key header route follows Claude Code's documented --header option but was not run end to end.
Bolta on Instagram

What Bolta does on Instagram

Instagram will not take text alone. Bolta needs an image or video before it will approve the post, so the draft starts with the media you want to use.

  • Feed posts, Reels and Stories. A post is a feed post unless you set Reels or Story.
  • An image or video is required for every Instagram post.
Limits and format

Instagram limits and format rules

Network rules last checked 2026-07-28. Bolta's posting rules for your workspace (get-posting-rules) win if they differ from this page.

Not promised for Instagram from Claude Code: Replies to Instagram comments and a search for Instagram conversations. Bolta's reply tools are not wired for Instagram, so this page does not promise either. Collab posts, Close Friends and direct messages.

Instagram limits and format rules
What to knowInstagram's own ruleWhat Bolta does
Caption lengthNot stated on this page.2,200 characters. Longer text is trimmed back to the last whole sentence or word that fits. That applies to the caption Bolta builds from your text. A caption you set yourself is sent as written, with no length check.
Reel lengthReels can be up to 20 minutes long, with 3 minutes the recommendation cutoff.Bolta does not check video length or file size, so Instagram makes that call.
CarouselsOne post can hold up to 20 photos and videos as a swipeable carousel.A carousel in Bolta takes 2 to 10 files.
Image sizeInstagram caps shared photos at 1080 pixels wide, sizing larger uploads down.Feed images should sit between 4:5 and 1.91:1, and Story images between 9:16 and 1.91:1.
Story videoA story video up to 60 seconds stays one clip. Longer footage is broken into several clips.Bolta does not check video length. A Story cannot be a carousel.
Best practices

Claude Code jobs for Instagram, and how to write them

  • Draft launch posts from a README section before you push a release
  • Review what Bolta has queued without leaving the terminal
  • Start with the media. Instagram needs an image or video, so attach it before you ask for the caption.
Prompts

Example prompts for Instagram

Things to type in Claude Code. Each one asks for a draft and shows you the text first.

Read the top entry in CHANGELOG.md and draft an Instagram caption for the launch image I attach

Which Bolta brands can you see, and which social accounts are connected to each? Do not change anything.

Draft an Instagram caption from the README tagline and tell me which image or video the post still needs

Send the three drafts you just saved to our reviewer for approval, and do not publish anything.

Review

Bolta saves a draft, you read the exact text, you say yes

  1. 01

    Bolta saves a draft

    Claude Code asks Bolta for the Instagram post in your brand voice (save-post). A saved draft is never public.

  2. 02

    You read the exact text

    On Instagram the exact text includes the caption and the media it sits on, and whether it is a feed post, a Reel or a Story.

  3. 03

    You say yes

    Only then does Bolta schedule or publish (publish-post), in your workspace's timezone. Safe Mode, client sign-off and brand approval rules still apply.

Claude Code and Bolta

Using Claude Code for Instagram

Parts of this route are not confirmed. The note above says which.

For Instagram, Claude Code, from Anthropic, reaches Bolta through Plugin from the bolta-skills marketplace, or claude mcp add. Sign-in: Sign in (OAuth) from /mcp. The Instagram account itself is connected inside Bolta, not in Claude Code.

Claude Code is a terminal coding agent, so the natural Instagram job is turning a changelog, README or release notes already in your repo into a draft. Bolta's plugin for it bundles the connection and a skill.

An illustration from the Claude Code guide, not real output. You ask: What is waiting for my approval in Bolta right now? The reply goes along these lines: You have drafts waiting in your inbox, with the account and text for each. I have not approved or changed any of them. Tell me which to approve, and I will show you the exact text first. Read only. Nothing changed.

The plugin installs the connection and the skill. If you already added Bolta yourself, installing the plugin on top leaves two Bolta entries on one organization. In that case add only the skill with npx skills add boltaai/bolta-skills --skill bolta.

Claude Code adds servers at local scope by default, which is just you in the current project. User scope follows you across all your projects. Project scope writes a .mcp.json file in the project that can be committed so a team shares a setup, and Claude Code asks each person to approve it in an interactive session. Plugins install at user, project or local scope too. Each person still signs in to Bolta as themselves, and the sign-in follows their own Bolta role.

Between tasks, ask Claude Code to describe what you shipped since your last post and draft it in your voice. It can read the commit messages, the changelog and the files you touched. It does not know why a change mattered to a customer unless you tell it, so add one line of intent to the prompt.

  • Draft from your repo. Changelog, README and release notes become drafts in your voice and the network's rules, saved without publishing.
  • Send to a teammate for sign-off. Route drafts to a named reviewer on the brand instead of approving them yourself.
  • Check connected accounts. It reads the networks connected to that brand, so it will not draft for one you have not connected.
  • Load your voice. It pulls your saved voice and business details before writing a word.
  • Setup: Say set me up. Type set me up in the chat, or run /bolta:bolta. Claude reads your brands and asks for your site, your voice or which accounts to connect. Drafts save freely. Nothing goes out until you say yes.
  • Setup: Check it works without changing anything. Ask: Which Bolta brands can you see, and which social accounts are connected to each? Do not change anything. Claude should list the brands you ticked and their networks, and draft nothing.
  • Plugin from the bolta-skills marketplace. /plugin marketplace add boltaai/bolta-skills, then /plugin install bolta@bolta-marketplace. It brings the connection and the skill. Still beta (plugin v0.5.3).
  • Reading the repo, drafting from it and chatting happen only while a Claude Code session is open.
  • Plugin (recommended). Choose this if you have not connected Bolta before. Two slash commands add the connection and the Bolta skill together, then /mcp signs you in. It is the path Bolta tests most.
Connect

Connect Claude Code to Bolta

Two slash commands, then a browser sign-in. You tick the brands Claude Code may reach.

FAQ

Instagram questions, answered for Claude Code

Can Claude Code post text to Instagram without an image?
No. Bolta will not approve an Instagram post without an image or video, so attach the media first. A post is a normal feed post unless you ask for a Reel or a Story.
How long can an Instagram caption from Claude Code be?
Bolta uses 2,200 characters and trims a longer caption back to the last whole sentence or word that fits. That applies to the caption Bolta builds from your text, so a caption you set yourself is sent as written, unchecked.
Do I need an API key?
No. Signing in from /mcp is the recommended route and needs no key. Posts from a sign-in are held as AI drafts on your review list, while a pasted API key skips that hold.
Claude Code does not see the Bolta tools. What should I check?
Run /reload-plugins, then /mcp, and make sure Bolta shows as connected rather than needing sign-in. If you see two Bolta entries, remove one.
Can my whole team share one Bolta setup through the repo?
Claude Code's project scope writes a .mcp.json file you can commit, and each person approves it and signs in as themselves. Their Bolta role decides what they can do, so a shared file never shares one person's permissions.
I see two Bolta entries in /mcp.
You installed the plugin and also added Bolta yourself. Keep one and remove the other. If you keep your own connection, add only the skill with npx skills add boltaai/bolta-skills --skill bolta.
Does Claude Code publish Instagram posts without my yes?
No. Nothing is approved, scheduled or published until you say yes to that Instagram post. Whether Claude Code completes the connection is not fully confirmed, so read the note above first.

More from Claude Code

Claude Code can work with the other networks Bolta publishes to. Each page has its own limits and review notes.

Instagram from other AI agents

The same Instagram limits apply whichever agent asks. The connection and the setup are what change.

Try an Instagram draft from Claude Code

Connect Claude Code, ask for an Instagram draft and read the exact text. Nothing goes live until you say yes.