A Model Context Protocol 서버로 포장 Instagram Graph API ** so Claude (또는 MCP 클라이언트)는, 게시, 코멘트를 읽을 수 있습니다, DM, Instagram ** Business 또는 Creator 계정에서 통찰력을 잡아.

5개의 기능 영역에서 24개의 공구 — 단면도/미디어, 출판, 의견, DMs, 그리고 통찰력 - FastMCP + httpx에 내장.

빠른 설치

또는 uv:

설치

##1. 메타 앱 만들기

1. https://developers.facebook.com/apps → Create 앱 → 사용 사례 ** 기타 ** → 유형 ** 비즈니스**.
2. 앱 대시보드에서 Instagram 제품 추가 (제품 → Instagram → 설정).

##2. Instagram Business/Creator 계정 연결

Business 또는 Creator로 전환한 Instagram 계정이 필요합니다. Facebook페이지. 앱 대시보드에서 **Instagram → API 설정 Facebook 로그인 → 단계 1 : 액세스 토큰 생성 ** 및 계정 연결.

##3. 필요한 권한을 얻으십시오.

이 범위를 가진 토큰 생성 (Graph API Explorer 또는 Instagram API에서 설정 페이지):

• [T2]]
• [T3]
• [T4]]
• [T5]
• [T6]]
• [T7]]

instagram-mcp

A Model Context Protocol server that wraps the Instagram Graph API so Claude (or any MCP client) can read, publish, comment, DM, and pull insights from an Instagram Business or Creator account.

24 tools across five capability areas — profile/media, publishing, comments, DMs, and insights — built on FastMCP + httpx.

Quick install

pip install instagram-mcp

Or with uv:

uv tool install instagram-mcp

Setup

1. Create a Meta App

1. Go to https://developers.facebook.com/apps → Create app → use case Other → type Business.
2. In the app dashboard, add the Instagram product (Add Product → Instagram → Set up).

2. Link an Instagram Business/Creator account

You need an Instagram account switched to Business or Creator, linked to a Facebook Page. In the app dashboard, walk through Instagram → API setup with Facebook login → Step 1: Generate access tokens and link your account.

3. Get the required permissions

Generate a token with these scopes (in Graph API Explorer or the Instagram API setup page):

• instagram_basic
• instagram_content_publish
• instagram_manage_comments
• instagram_manage_messages
• instagram_manage_insights
• pages_show_list
• pages_read_engagement
• business_management

While your app is in Development mode, only accounts in your app’s Roles list (admins/developers/testers) can authenticate. That’s fine for personal use. For other users, you need App Review with Advanced Access.

4. Mint a long-lived Page token

The fastest way: run the bundled helper.

instagram-mcp-get-token

It will ask for your short-lived user token + app ID/secret, exchange it for a long-lived user token, list your linked IG accounts, and write .env for you.

Manual alternative:

# Exchange short-lived user token → long-lived (~60 days)
curl -G "https://graph.facebook.com/v21.0/oauth/access_token" \
  --data-urlencode "grant_type=fb_exchange_token" \
  --data-urlencode "client_id=YOUR_APP_ID" \
  --data-urlencode "client_secret=YOUR_APP_SECRET" \
  --data-urlencode "fb_exchange_token=SHORT_LIVED_TOKEN"

# Find your Pages and their IG accounts
curl -G "https://graph.facebook.com/v21.0/me/accounts" \
  --data-urlencode "fields=name,instagram_business_account,access_token" \
  --data-urlencode "access_token=LONG_LIVED_USER_TOKEN"

Use the Page’s access_token (never expires) and the instagram_business_account.id of the linked IG account.

5. Configure .env

IG_USER_ID=17841446575432302