Instagram Mcp Server

MCP设计创作

提供方 drashrafsaiyed-cyber

设计创作 未标注 API Key 社区 / 第三方 Claude DesktopClaudeCursorCodex
查看接入方式

Control your Instagram from Claude — publish photos, reels, carousels, read insights, manage comments and DMs. 14 tools via Instagram Login API. One-click free Render deploy for Claude Web and mobile.

一句话选型结论

按资料字段整理

Instagram Mcp Server 属于设计创作类 MCP 服务器,传输方式未标注,API Key,可直接接入 Claude Desktop、Claude、Cursor 等,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类设计创作 传输方式未标注 鉴权API Key 部署方式未标注
GitHub 星标 未标注 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

设计创作
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

instagramsocial mediapython

安装与配置

未标注 API Key
上游未给出传输方式
uv --directory /path/to/instagram-mcp run server.py

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
出图与素材

生成配图、图标与素材。

设计稿处理

读取设计稿、批量改尺寸或导出。

内容生成

按主题生成文案与视觉草稿。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude Desktop、Claude、Cursor,换客户端不用重新研究配置。

先想清楚的地方

  • 使用前要准备好API Key对应的凭据,并按最小权限配置。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在设计创作场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Instagram Mcp Server当前 未标注 未标注 未标注 有 未标注
Cursor Talk To Figma MCP Da1c7911 40 未标注 未标注 无 2026-05-17
Blender MCP 17 stdio · 本地进程 本地部署 有 2026-05-18
Nova Canvas MCP Server 2 stdio · 本地进程 本地部署 有 2026-05-17
Figma Context MCP 3aaa8d28 未标注 未标注 支持远程部署 无 2026-05-17
kreuzberg 未标注 stdio · 本地进程 本地部署 有 2026-04-12

服务器档案

设计创作
字段来自项目仓库与公开索引,中文说明由本站标注
提供方drashrafsaiyed-cyber上游标注的维护方 drashrafsaiyed-cyber
分类设计创作本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式API Key远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · Cross-platform本地安装时用到的包标识与运行时
部署类型未标注上游给出的部署形态
最近核验未标注上游最后核验时间

详细介绍

8.2 KB
来自项目仓库与上游目录的原文,未做删改

📸 Instagram MCP Server

Control your Instagram from Claude — post, analyze, reply to DMs, manage comments. All by chatting.


> 🎬 Demo GIF coming soon — Claude posting a reel, reading insights, replying to comments live on screen.


What You Can Do

Ask Claude in plain English. It handles the API.```
"Show my last 10 posts and which got the most reach"
"Post this image with caption: Monday motivation 💪 #AI #Health"
"Read my DMs from today and draft replies for the questions"
"Hide all spam comments on my latest reel"
"What are my account insights for this week?"
"Which of my reels got the best watch time?"


---

## Use Cases

### 📊 Content Creator
- Morning briefing: *"Show yesterday's post performance — reach, saves, shares"*
- Strategy: *"Compare my last 5 reels by reach and tell me what worked"*
- Scheduling prep: *"Draft 3 caption options for this fitness post"*

### 🏥 Doctor / Professional
- Engagement: *"Reply to all comments on my last post professionally"*
- Growth tracking: *"How many followers did I gain this week?"*
- Content audit: *"List all posts from this month with their engagement rates"*

### 🛍️ Small Business
- Customer service: *"Show DMs from the last 24 hours and reply to order questions"*
- Publishing: *"Post this product photo with this caption and these hashtags"*
- Analytics: *"Which post type (reel/carousel/photo) gets me the most reach?"*

---

## Tools (14 total)

| Category | Tool | What it does |
|----------|------|-------------|
| **Account** | `get_account_info` | Followers, bio, post count |
| | `update_profile` | Update bio text and/or website URL |
| | `list_recent_media` | Last N posts with engagement stats |
| | `get_account_insights` | Reach, profile views, follower growth |
| **Insights** | `get_media_insights` | Per-post reach, saves, views, interactions |
| **Publishing** | `publish_photo` | Post a photo with caption + hashtags |
| | `publish_reel` | Post a Reel (video) |
| | `publish_carousel` | Post 2–10 images as carousel |
| **Comments** | `get_comments` | Read all comments on a post |
| | `reply_to_comment` | Reply to a comment |
| | `hide_comment` | Hide spam/unwanted comments |
| | `delete_comment` | Permanently delete a comment |
| **Engagement** | `like_media` | Like a post or reel |
| | `unlike_media` | Unlike a post or reel |
| | `like_comment` | Like a comment |
| **Content** | `delete_post` | Permanently delete a post |
| **Hashtags** | `search_hashtag` | Search public posts by hashtag |
| **Events** | `list_events` | List upcoming events |
| | `create_event` | Create a new event (health camps, workshops) |
| **Ads** | `get_ad_accounts` | List linked ad accounts |
| | `get_ad_insights` | Get ad spend, reach, CTR |
| **DMs** | `list_conversations` | List active DM threads |
| | `get_messages` | Read messages in a thread |
| | `send_dm` | Reply to a DM (24h window) |
| | `send_human_agent_dm` | Reply within 7-day Human Agent window |

---

## Quick Start

### Option A — Claude Web + Mobile (Recommended)

**1. Deploy your server (free, 2 min):**

Fill in `META_ACCESS_TOKEN` and `IG_USER_ID` when prompted. (How to get these ↓)

**2. Connect to Claude web:**
- claude.ai → Settings → Integrations → Add Integration
- Paste: `https://your-app-name.onrender.com/mcp`

**3. Done.** Open a new chat and try: *"Show my recent Instagram posts"*

---

### Option B — Claude Desktop (Local)```bash
git clone https://github.com/drashrafsaiyed-cyber/instagram-mcp
cd instagram-mcp
uv sync
cp .env.example .env
# Fill .env with your token and user ID
uv run server.py

Add to claude_desktop_config.json:```json
{
"mcpServers": {
"instagram": {
"command": "uv",
"args": ["--directory", "/path/to/instagram-mcp", "run", "server.py"],
"env": {
"META_ACCESS_TOKEN": "your_token",
"IG_USER_ID": "your_ig_user_id",
"ACCOUNT_NAME": "My Instagram"
}
}
}
}


---

### Option C — Multiple Instagram Accounts (Claude Desktop)

Run the **same server folder** multiple times with different env vars. Claude sees each as a separate named MCP and never confuses them.```json
{
  "mcpServers": {
    "instagram-personal": {
      "command": "uv",
      "args": ["--directory", "/path/to/instagram-mcp", "run", "server.py"],
      "env": {
        "META_ACCESS_TOKEN": "TOKEN_FOR_ACCOUNT_1",
        "IG_USER_ID": "IG_USER_ID_1",
        "ACCOUNT_NAME": "Personal"
      }
    },
    "instagram-business": {
      "command": "uv",
      "args": ["--directory", "/path/to/instagram-mcp", "run", "server.py"],
      "env": {
        "META_ACCESS_TOKEN": "TOKEN_FOR_ACCOUNT_2",
        "IG_USER_ID": "IG_USER_ID_2",
        "ACCOUNT_NAME": "My Business"
      }
    }
  }
}

Claude will show separate tools per account — "Post this to My Business" picks the right one automatically.

> Each account must be a Business or Creator Instagram account, and must be added as a tester in your Meta app → Use cases → Step 2: Generate access tokens → Add account.


Getting Your Token

This server uses the Instagram Login API (graph.instagram.com) — the modern Meta approach for Instagram Business/Creator accounts.

Step 1 — Create or open your Meta app
1. Go to developers.facebook.com → My Apps
2. Create a new app or open an existing one
3. Add use case: "Manage messaging & content on Instagram"

Step 2 — Generate your access token
1. Use cases → Customize → API Setup with Instagram Login
2. Step 2: Generate access tokens → click Generate next to your account
3. Copy the token → this is your META_ACCESS_TOKEN
4. Your numeric IG User ID is shown below your username on the same page

Step 3 — Refresh before expiry (60 days)```bash
curl "https://graph.instagram.com/refresh_access_token?grant_type=ig_refresh_token&access_token=YOUR_TOKEN"

Or just run this in your project folder:```bash
uv run python -c "
import httpx, re
from pathlib import Path
env = Path('.env').read_text()
token = re.search(r'META_ACCESS_TOKEN=(.+)', env).group(1).strip()
r = httpx.get('https://graph.instagram.com/refresh_access_token', params={'grant_type':'ig_refresh_token','access_token':token})
new = r.json()['access_token']
Path('.env').write_text(env.replace(token, new))
print('Refreshed. Expires in:', r.json()['expires_in']//86400, 'days')
"

Requirements

  • Instagram Business or Creator account
  • Meta Developer app with "Manage messaging & content on Instagram" use case
  • Python 3.11+

> Publishing note: Images and videos must be at a public HTTPS URL — Instagram fetches from your URL. Use Cloudinary (free), S3, or a public GitHub raw URL. Local file paths won't work.


Architecture```

Claude (Web/Desktop)
│ MCP protocol
▼
instagram-mcp server (FastMCP 3.x, streamable-http or stdio)
│ HTTPS REST
▼
graph.instagram.com (Instagram Login API v21.0)
│
▼
Your Instagram account
```

Why graph.instagram.com and not graph.facebook.com?
This server uses the newer Instagram Login API which issues IGAA... tokens and routes through graph.instagram.com. The older Facebook Graph API approach required a linked Facebook Page and EAA... tokens. The new flow is simpler — just your Instagram account, no Facebook Page needed.


Troubleshooting

Error Fix
Cannot parse access token Token expired or wrong type. Regenerate via the steps above.
code 100 on insights Invalid metric name. Metrics differ between account vs media endpoints.
code 190 Token expired. Run the refresh command.
Container processing failed Video too long (>90s), wrong codec, or URL returns 404 after first fetch.
Empty DM list No active 24h messaging window. Someone needs to DM you first.
Claude doesn't see tools Restart Claude Desktop fully (tray icon → Quit). Check logs at %APPDATA%\Claude\logs\.

Contributing

PRs welcome. If you add a new tool or fix a metric name mismatch, please:
1. Test against a real Instagram account
2. Update the tool table in this README
3. Note which API permission the new tool requires


License

MIT — free to use, fork, and deploy commercially.


Built with FastMCP · Powered by Instagram Graph API

常见问题

7 问
答案由本站依据条目字段整理,不引用上游原文
Instagram Mcp Server 怎么安装?

在客户端按下面的安装命令接入:uv --directory /path/to/instagram-mcp run server.py。装完在客户端配置里引用同一个包或端点。

Instagram Mcp Server 怎么在 Claude Desktop、Claude、Cursor 里配置?

它的传输方式未标注,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Instagram Mcp Server 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Instagram Mcp Server 需要 API Key 吗?

资料标注需要API Key认证,使用前准备好对应凭据,并按最小权限配置。

Instagram Mcp Server 支持哪些客户端?

资料标注支持 Claude Desktop、Claude、Cursor、Codex、Zed;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Instagram Mcp Server 能提供哪些能力?

资料显示能力标签包括 instagram、social media、python、fastmcp、claude。具体工具清单以官方文档为准。

Instagram Mcp Server 需要什么运行环境?

运行时为 Cross-platform。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 未标注。