Instagram MCP Server

Name: Instagram MCP Server
Author: jlbadano

@jlbadano

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

基本情報

カテゴリ

その他

ライセンス

MIT license

ランタイム

python

トランスポート

stdio

公開者

jlbadano

設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

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

ツール

ツールは検出されませんでした

ツールは README から自動的に抽出されます。メンテナーは ## Tools という見出しの下に記載することで、このタブに反映できます。

概要

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.