Instagram MCP Server

What is Instagram MCP Server?

A Model Context Protocol (MCP) server that fetches Instagram posts by leveraging an existing Chrome login session. It is designed for developers who need to programmatically retrieve Instagram content with type-safe, modular architecture.

How to use Instagram MCP Server?

Install dependencies with npm install, build with npm run build, then run with CHROME_USER_DATA_DIR=/path/to/chrome/profile npm start. Use the get_instagram_posts tool to fetch posts by providing a username and optional parameters like limit and save directory.

Key features of Instagram MCP Server

• Modular architecture with clear separation of concerns
• Type-safe implementation using TypeScript
• Configurable through environment variables
• Automatic media downloading and metadata generation
• SEO-friendly description generation
• Standardized error handling with JSON-RPC 2.0 compliance

Use cases of Instagram MCP Server

• Fetch recent posts from an Instagram profile for analysis
• Automate media downloading and metadata generation for content curation
• Integrate Instagram post retrieval into AI assistants or automation workflows
• Build type-safe tools that need Instagram data without manual scraping

FAQ from Instagram MCP Server

What dependencies or runtime does Instagram MCP Server require?

It requires Node.js and a local installation of Chrome with an existing login session for Instagram. The path to the Chrome user data directory must be provided as an environment variable.

How does Instagram MCP Server authenticate with Instagram?

It uses your Chrome browser’s existing login session—no separate API keys or credentials are needed. Ensure Chrome has an active Instagram session at the specified user data directory.

What is the limit for fetching Instagram posts?

You can fetch between 1 and 50 posts, or use the string "all" to retrieve all available posts. The limit parameter is optional.

Where does Instagram MCP Server save media files and metadata?

Media and metadata are saved to a directory specified by the optional saveDir parameter. If not provided, default paths from configuration are used.

What transport protocol does Instagram MCP Server use?

It communicates via stdio transport using JSON-RPC 2.0, compatible with MCP hosts that support standard input/output.