Instagram Download MCP Server
This MCP server enables AI assistants to download various types of Instagram content to the local filesystem:
Download Instagram posts - Download images, videos, and carousel posts from Instagram URLs
Download Instagram videos - Download videos from posts, Reels, and IGTV
Download Instagram stories - Download stories from a target user (requires login)
Download Instagram highlights - Download highlight collections with optional filtering by title (requires login)
Download Instagram profile pictures - Download high-resolution profile pictures for any username
Customization options:
Custom download directory paths
Save metadata as JSON files
Save captions as text files
Control video inclusion in post downloads
Authentication:
Supports both authenticated and unauthenticated access (configurable via environment variables)
Stories and highlights require login credentials; posts, videos, and profile pictures work without authentication
Enables downloading Instagram content including posts (images, videos, carousels), Reels, IGTV, Stories, Highlights, and profile pictures, with optional metadata and caption extraction.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Instagram Download MCP Server download the latest post from @natgeo"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
ig-download-mcp
English | 繁體中文
An Instagram MCP (Model Context Protocol) server powered by Instaloader, enabling AI assistants (Claude / Claude Code / Codex) to download Instagram content.
Features
Download posts (images / videos / carousel)
Download videos (Reels / IGTV / video posts)
Download Stories (login required)
Download Highlights (login required)
Download profile pictures
Optionally save metadata (JSON) and captions (text files)
.envand environment variable support for credentials
Requirements
Python >= 3.13
Quick Start
1) Clone
git clone https://github.com/<YOUR_ORG_OR_USER>/ig-download-mcp.git
cd ig-download-mcp2) Install dependencies
uv venv
uv sync3) Configure credentials (recommended)
cp .env.example .env
# Edit .env and fill in your Instagram credentials4) Run the MCP server
uv run ig-download-mcpMCP Configuration
Replace /path/to/ig-download-mcp with your actual installation path.
Claude Desktop
Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS)
or the equivalent file for your platform:
{
"mcpServers": {
"ig-download-mcp": {
"command": "uv",
"args": ["--directory", "/path/to/ig-download-mcp", "run", "ig-download-mcp"]
}
}
}Claude Code
Edit ~/.claude.json:
{
"mcpServers": {
"ig-download-mcp": {
"command": "uv",
"args": ["--directory", "/path/to/ig-download-mcp", "run", "ig-download-mcp"]
}
}
}Codex (OpenAI)
Edit ~/.codex/config.toml:
[mcp_servers.ig_download_mcp]
command = "uv"
args = ["--directory", "/path/to/ig-download-mcp", "run", "ig-download-mcp"]Available Tools
Tool | Description | Login Required |
| Download posts (images/videos/carousel) | Optional |
| Download videos only | Optional |
| Download stories | Required |
| Download highlights | Required |
| Download profile picture | Optional |
Credentials
Recommended: create .env in the project root:
cp .env.example .env
# Edit .env and fill in your Instagram credentialsOr set environment variables:
export IG_USERNAME="your_username"
export IG_PASSWORD="your_password"Notes / Disclaimer
This project is not affiliated with Instagram or Meta.
You are responsible for complying with Instagram's Terms of Service and all applicable laws.
Stories / Highlights require login.
If 2FA / challenge flows are triggered, Instaloader may fail.
Instaloader includes rate limiting; avoid high-frequency downloads.
License
MIT
Available Tools
5 toolsdownload_instagram_highlightsB
Download Instagram highlights for a target user.
Note: This feature requires login.
Args: username_target: Target Instagram username. highlight_title: Optional highlight title filter. username: Instagram username for authenticated access. password: Instagram password for authenticated access. download_root: Optional override for download directory.
Returns: A JSON-serializable dict containing download results.
Inputs: username_target (required), highlight_title, username, password, +1 more. Returns: object
download_instagram_postA
Download an Instagram post's media files to the local filesystem.
Args: url: Instagram post/reel/tv URL. include_videos: Whether to download videos alongside pictures. save_metadata: Save JSON metadata files when available. save_caption: Save caption into a text file when available. username: Optional Instagram username for authenticated access. password: Optional Instagram password for authenticated access. download_root: Optional override for download directory.
Returns: A JSON-serializable dict containing download results.
Inputs: url (required), include_videos, save_metadata, save_caption, +3 more. Returns: object
download_instagram_profile_picB
Download an Instagram profile picture to the local filesystem.
Args: username_target: Target Instagram username. username: Optional Instagram username for authenticated access. password: Optional Instagram password for authenticated access. download_root: Optional override for download directory.
Returns: A JSON-serializable dict containing download results.
Inputs: username_target (required), username, password, download_root. Returns: object
download_instagram_storiesA
Download Instagram stories for a target user.
Note: This feature requires login.
Args: username_target: Target Instagram username. username: Instagram username for authenticated access. password: Instagram password for authenticated access. download_root: Optional override for download directory.
Returns: A JSON-serializable dict containing download results.
Inputs: username_target (required), username, password, download_root. Returns: object
download_instagram_videoA
Download an Instagram video's media files to the local filesystem.
Args: url: Instagram post/reel/tv URL. username: Optional Instagram username for authenticated access. password: Optional Instagram password for authenticated access. save_metadata: Save JSON metadata files when available. save_caption: Save caption into a text file when available. download_root: Optional override for download directory.
Returns: A JSON-serializable dict containing download results.
Inputs: url (required), username, password, save_metadata, +2 more. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
The tools are mostly distinct with clear purposes: highlights, posts, profile pictures, stories, and videos. However, there is some overlap between download_instagram_post and download_instagram_video, as both handle posts/reels/tv URLs, which could cause confusion about which to use for video content. The descriptions help clarify, but the boundaries are not perfectly clear.
All tool names follow a consistent verb_noun pattern with 'download_instagram_' as a prefix, followed by the specific target (e.g., highlights, post, profile_pic, stories, video). This uniformity makes the tool set predictable and easy to understand, with no deviations in naming style.
With 5 tools, this server is well-scoped for its purpose of downloading various Instagram content types. Each tool serves a distinct function (highlights, posts, profile pictures, stories, videos), and the count is neither too sparse nor excessive, fitting typical expectations for a focused download utility.
The tool set covers key Instagram content types for downloading: highlights, posts, profile pictures, stories, and videos, providing good coverage for the domain. A minor gap is the lack of a tool for downloading multiple posts or feeds, which might be useful for batch operations, but agents can work around this by iterating with the existing tools.
Related MCP Connectors
View and download public Instagram posts, reels, stories, highlights, followers, comments, no login
Live public Instagram and TikTok data for AI assistants: profiles, posts, stories, followers.
Instagram tag/user/post search, details, comments/replies, users/posts, video/Reels speech-to-text.
Instagram, TikTok, YouTube and other social media links to direct media download URLs.