Instagram + PostOnce
Instagram MCP Server
Instagram MCP server for Claude, ChatGPT, Cursor and Codex. Your AI agent can write, publish and schedule Instagram photo posts, carousels and Reels on your Business or Creator account through Instagram's official API, with no scraping, no browser automation and no Instagram developer app.
Requires a PostOnce account, API access, and your own API key.
https://postonce.to/mcpWhat your agent can do on Instagram
Publish a photo post now
create_post with one image on your connected Instagram account
Post a carousel (2 to 10 photos or videos, mixed)
create_upload_url, upload each file, then create_post with media in order
Post a Reel (3 seconds to 15 minutes) with a custom cover
create_post with one video; thumbnail_url sets the cover
Schedule any of these for later
create_post with publish_at
Label a post as AI-generated
platform_options: {"ai_generated": true}
Save a draft to finish later
create_draft
Check whether a post went out, and get its URL
get_post
Change or cancel a scheduled post
update_post, cancel_post
Post the same thing to Instagram and other platforms
Add more targets to create_post (TikTok, YouTube, Facebook, LinkedIn, X, Threads, Pinterest, Bluesky)
Captions go up to 2,200 characters. Images are published as JPEG, up to 8 MB, between 4:5 portrait and 1.91:1 landscape.
Not supported: Stories, text-only posts, collaborators, user tags, location, alt text, first comments, analytics, reading or replying to comments, DMs, and editing or deleting posts that are already live. This server publishes; it doesn't browse Instagram for you.
Connect Instagram to your agent
You need a PostOnce account with your Instagram account connected. Try it free for 7 days without entering a card.
Claude and ChatGPT
Add a custom connector with this URL and sign in with PostOnce. No API key.
https://postonce.to/mcpClaude Code
Install the plugin for the connection and the Instagram skills, then set POSTONCE_API_KEY.
claude plugin marketplace add postoncehq/plugins
claude plugin install instagram-mcp@postoncehqCursor, Codex and other clients
Point any MCP client at the URL above over Streamable HTTP with the header Authorization: Bearer and your PostOnce API key. Never paste the key into chat.
Instagram skills included
The plugin ships these Agent Skills so your agent knows what works on Instagram before it posts. They work in Claude Code, Codex, Cursor and any client that reads Agent Skills.
- instagram-caption-generator
Writes feed, Reel and carousel captions: a first line that earns the "more" tap, a clear CTA, 3 to 5 hashtags, and alt text for you to add in the app.
- instagram-carousel-maker
Plans and builds a 2 to 10 slide carousel at 1080×1350, with the caption, ready to upload and post.
- instagram-reel-script
Writes a Reel script: hook options, beats, on-screen text, cover text and the caption.
- instagram-bio-generator
Writes 150-character bio options and a searchable name field for you to paste into Instagram.
- instagram-hashtag-generator
Picks a small set of specific hashtags for one post, instead of a wall of 30.
- instagram-content-calendar
Plans 1 to 4 weeks of posts, carousels and Reels from your goals or a source you want to repurpose, then schedules them.
- postonce
Publishing workflow: pick the right account, upload media, schedule, and confirm the post actually went live.
Try these prompts
Turn these 6 photos into an Instagram carousel with a caption and post it Friday at noon.
Write a caption for this Reel and schedule it for tonight at 7pm with a custom cover image.
Plan a week of Instagram posts from our latest blog post and schedule them.
Instagram MCP questions
Does Instagram have an official MCP server?
This server uses Instagram's official API through PostOnce. You connect your account once with Instagram's own login, and your agent publishes through that connection.
Can Claude post to Instagram?
Yes, once it's connected to an MCP server that can publish, like this one. Claude writes the caption, uploads your photos or video, then calls create_post.
Is it safe for my Instagram account?
Yes. Posts go through Instagram's official API with the permissions you grant when you connect. Many Instagram MCP servers on GitHub drive a logged-in browser session or an unofficial, reverse-engineered API instead, which Instagram's Terms of Use don't allow and which can get accounts restricted.
Can it post Reels and carousels?
Yes. One video publishes as a Reel (3 seconds to 15 minutes, up to 1 GB), and you can set its cover image. Carousels take 2 to 10 photos or videos, mixed; carousel videos must be 3 to 60 seconds.
Can it post Instagram Stories?
No. Stories can't be published through this server. Feed posts, carousels and Reels can.
Do I need an Instagram developer app or API approval?
No. PostOnce holds the Instagram API access; you just connect your Business or Creator account.
Is it free?
The skills are free and MIT-licensed on GitHub. Publishing runs through a PostOnce account, which you can try free for 7 days without entering a card. After that, see pricing.
MCP servers for other platforms
The same connection publishes everywhere PostOnce supports. Each platform has its own skills: LinkedIn MCP, TikTok MCP, YouTube MCP, Facebook MCP, X (Twitter) MCP, Threads MCP, Bluesky MCP, Pinterest MCP.
Let your agent post to Instagram
Requires a PostOnce account, API access, and your own API key.