Instagram MCP server for your agent

To give Claude, Cursor, ChatGPT or another MCP client Instagram data, add Apify's hosted MCP server with the Actors ticked below as tools (4 by default); the URL is in every config. Sign in with your Apify account or pass an API token; each call runs the Actor and returns Instagram records to the agent.

One click, signs in with Apify on first use:

Any other client, one command (writes the config for 25+ agents, including Windsurf, Zed, Cline and Goose):

npx add-mcp "https://mcp.apify.com/?tools=fetch-actor-details,dataspryva/instagram-profile-scraper-bio-and-posts,dataspryva/instagram-posts-and-reels-data-scraper,dataspryva/instagram-transcript-scraper-reels-and-video,dataspryva/instagram-downloader-api-reels-video-and-photo" --name apify-instagram

Catalogue Actors
4
In this bundle
4
Official API
Limited
Data checked
2026-11-12

Config for your client

Claude Code configterminal or .mcp.json

claude mcp add --transport http apify-instagram "https://mcp.apify.com/?tools=fetch-actor-details,dataspryva/instagram-profile-scraper-bio-and-posts,dataspryva/instagram-posts-and-reels-data-scraper,dataspryva/instagram-transcript-scraper-reels-and-video,dataspryva/instagram-downloader-api-reels-video-and-photo"

  1. Run the command in your project folder. Add --scope user to make it available in every project.
  2. Start Claude Code, type /mcp, pick the server and sign in to Apify in the browser window.
  3. No browser sign-in? Add --header "Authorization: Bearer YOUR_APIFY_TOKEN" to the command instead.

Sign-in: OAuth sign-in on first use, or a token header.

Validated, not executed: 7 of 7 checks pass
  • Uses Apify's hosted MCP endpoint over HTTPS
  • The tools parameter lists exactly the chosen Actors as owner/name
  • JSON configs parse and use the client's top-level key and the same URL
  • Codex TOML has a [mcp_servers.<name>] table with url and bearer_token_env_var
  • CLI commands quote the same URL and use the streamable HTTP transport
  • One-click install links decode back to the same URL and carry no token
  • Only placeholders, no real token

Official API or an Actor?

Instagram has an official API with limited access

The official API covers professional accounts and their own content. It does not provide general search over public profiles and posts.

No published per-call price for standard use; access depends on Meta app configuration.

Rate limits and permitted scopes apply. Public-content scraping is outside the official API.

Instagram Platform API documentation

Public business/profile data only; respect Instagram's terms; not legal advice.

Which Actor for which job

  • Creator research: Instagram Profile Scraper - Bio & Posts collects public profiles by username with optional recent posts; its post output includes caption and hashtags.
  • Media retrieval: Instagram Downloader API - Reels, Video & Photo downloads media files with metadata; it returns filename and download_status.
  • Post analysis: Instagram Posts & Reels Data Scraper extracts posts, Reels and carousels; it returns post_url and collaborators.
  • Video transcription: Instagram Transcript Scraper - Reels & Video turns accessible captions or video speech into text; its output includes postUrl and postDescription.

Where it stops

The token-based configurations require your Apify API token, which authorizes Apify rather than an Instagram OAuth session. Recipe for Agents has not authenticated to Apify or Instagram for you. Public-profile extraction does not grant access to private accounts, and downloads or transcripts depend on accessible media and captions or speech. Instagram’s official API covers professional accounts and their own content; it does not offer general search across public profiles and posts.

Every Instagram Actor in the catalogue

ActorReturnsFieldsStore priceLast update
Instagram Profile Scraper - Bio & Posts Scrape public Instagram profiles from a list of usernames: bio, followers, following, post count, verified badge and bio links. Add recent… Fields include post_url, shortcode, post_id. 30 $0.70 per 1,000 results 2026-11-05
Instagram Downloader API - Reels, Video & Photo Downloaded Instagram media files with metadata Fields include filename, post_url, username. 11 $0.49 per 1,000 results 2026-11-10
Instagram Posts & Reels Data Scraper Instagram posts, Reels, IGTV and carousels: caption, hashtags, author, photo and video links, likes, comments, location and music. Fields include post_url, shortcode, post_id. 25 $0.99 per 1,000 results 2026-10-31
Instagram Transcript Scraper - Reels & Video Instagram video to text: paste many reel, post or IGTV links and get each transcript with creator, caption and likes. Reads Instagram… Fields include postUrl, profileUrl, shortCode. 22 $0.50 per 1,000 results 2026-11-06

Store links: instagram-profile-scraper-bio-and-posts, instagram-downloader-api-reels-video-and-photo, instagram-posts-and-reels-data-scraper, instagram-transcript-scraper-reels-and-video

Instagram recipes for n8n

  • Instagram posts to Google Sheets

    Log the latest posts of the Instagram profiles you track in a Google Sheet, with captions, likes, comments…

    InstagramGoogle Sheets
  • Instagram posts to Slack

    Post the latest posts of the Instagram profiles you watch to a Slack channel, with caption, likes and the…

    InstagramSlack

Troubleshooting

Why does the client say Unauthorized or invalid token?

Every Apify Actor tool needs a signed-in Apify account. Reconnect the server so the OAuth sign-in runs again, or switch to the token variant: an Authorization: Bearer header with an API token from Apify Console, Settings, API and integrations. For a local server the token must be in the server's own env block, not only in your shell.

Source: Apify MCP server README

Why did my agent's tool list change after an update?

Without a tools parameter Apify's server loads its default tool set, which changes between releases. The URLs on this site pin the tools with ?tools=, so the agent always gets the same Actor tool plus fetch-actor-details. Apify's README gives the same advice for production.

Source: Apify MCP server README

What happens when the agent sends input the Actor rejects?

The server answers with the Actor's input schema, so the agent can fix the arguments and call again. The fetch-actor-details tool in every scoped URL lets it read that schema before the first call.

Source: Apify MCP server README

Claude Code shows Needs authentication. Why?

The server is added but not signed in. Type /mcp in an interactive session and authenticate, or run claude mcp login with the server name. Headless runs with claude -p cannot complete OAuth, so sign in once interactively or use the --header token variant.

Source: Claude Code MCP documentation

Claude Code warns that a tool result is too large. What can I change?

Claude Code warns above 10,000 tokens of tool output and caps it at 25,000 by default (MAX_MCP_OUTPUT_TOKENS raises it). Ask the agent for fewer results per call, for example a lower result limit for the Actor.

Source: Claude Code MCP documentation

Cursor does not show the server's tools. What should I check?

Open the Output panel and pick MCP Logs to see the connection error. A deeplink install that does nothing usually means an older Cursor build; update it or paste the JSON into mcp.json by hand.

Source: Cursor MCP documentation

Questions

How do I get Instagram profile data into Claude?

Install the Apify MCP configuration in your Claude client and complete Apify authentication. Give Instagram Profile Scraper - Bio & Posts the public usernames you want to research, with recent posts included when needed.

Can Claude turn an Instagram Reel into text?

Select Instagram Transcript Scraper - Reels & Video and pass the Reel link. It reads available captions or uses speech-to-text, so the result depends on access to the video and its audio.

How can I ask Claude to download Instagram photos or videos?

Choose Instagram Downloader API - Reels, Video & Photo for media retrieval. Ask Claude to check the returned download status before treating a media file as available.

Do I need to sign into Instagram to use this MCP connection?

The configurations authenticate to Apify with an Apify API token and do not establish an Instagram OAuth session. These Actors cover public content, so the connection does not grant Claude access to private Instagram accounts.