Instagram MCP Server

Name: Instagram MCP Server
Author: jlbadano

@jlbadano

About Instagram MCP Server

A production-ready Model Context Protocol (MCP) server that enables AI applications to seamlessly interact with Instagram Business accounts.

#instagram #facebook #mcp #mcp-server

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "ig-mcp": {
      "command": "python",
      "args": [
        "scripts/setup.py"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Instagram MCP Server?

A Model Context Protocol server that integrates with Instagram’s Graph API to let AI applications interact with Instagram Business accounts programmatically. It is built for developers using MCP-compatible agents (like Claude Desktop) and requires an Instagram Business account linked to a Facebook Page, a Facebook Developer Account, a long-lived access token, and Python 3.10+.

How to use Instagram MCP Server?

Clone the repository, install dependencies (pip install -r requirements.txt), set environment variables in a .env file (including INSTAGRAM_ACCESS_TOKEN, FACEBOOK_APP_ID, FACEBOOK_APP_SECRET, INSTAGRAM_BUSINESS_ACCOUNT_ID), then configure the MCP client (e.g., Claude Desktop) with the server command and arguments. Use natural language queries to trigger tools like getting profile info, analyzing posts, or publishing media.

Key features of Instagram MCP Server

Retrieve Instagram business profile details
Fetch recent posts with engagement metrics
Access post‑level analytics (likes, comments, shares)
Upload and publish images/videos to Instagram
List Facebook pages connected to the account

Use cases of Instagram MCP Server

Analyze post engagement and account insights
Schedule and publish media content via an AI assistant
Generate content strategy recommendations using built‑in prompts
Evaluate hashtag performance for marketing campaigns
Manage multiple Instagram business accounts through Facebook pages

FAQ from Instagram MCP Server

What prerequisites are required?

You need an Instagram Business account connected to a Facebook Page, a Facebook Developer Account, a long‑lived access token with the correct permissions, and Python 3.10+.

How do I get Instagram API credentials?

Follow the detailed authentication guide in AUTHENTICATION_GUIDE.md or the steps in the README: set up a Business account, create a Facebook App, add the Instagram Graph API product, request the required permissions, generate a long‑lived access token (via Graph API Explorer or OAuth flow), and configure environment variables.

What permissions are required for the access token?

instagram_basic, instagram_content_publish, instagram_manage_insights, pages_show_list, and pages_read_engagement.

How do I handle token expiration?

Long‑lived tokens expire after 60 days. Implement automatic refresh by calling the fb_exchange_token endpoint before expiration. The README provides sample Python code for checking token validity and refreshing it.

What are the rate limits?

Profile, media, and insights requests are limited to 200 calls per hour. Publishing is limited to 25 posts per day. The server implements intelligent rate limiting and recommends caching, batch requests, and exponential backoff.

Comments

More Other MCP servers

🚀 Model Context Protocol (MCP) Curriculum for Beginners

microsoft

This open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,

16.7K