instagram-mcp

# Instagram

### Your Instagram account in Claude, Cursor and AI agents: publish, reply and measure

Connect your own Instagram account to Claude, Cursor or your own agent. Through the official API: publish photos, videos, carousels, Reels and Stories, read and reply to comments, talk in DMs, and pull profile and media insights. With the Advanced plan the same account also likes posts, follows and unfollows, lists and views stories, and starts a DM conversation. Connect in 2 clicks (Business or Creator account) or with username and password, 2FA supported.

- 📸 **Really publishes**: photos, videos, carousels, Reels and Stories through the official API
- 💬 **Comments and DMs**: read, reply, mark as seen and list conversations
- 📈 **Profile and media insights**: reach, impressions, engagement
- ❤️ **Engagement on your own account** (Advanced plan): like a post, like a comment, follow, unfollow, list and view stories, start a DM conversation
- 🔑 **Two ways to connect**: 2 clicks (Business/Creator) or username and password with 2FA
- 🧾 **Async actions with a job id**: track every action's state (`get_job_status`, `list_jobs`)
- 🌐 **Mirrored REST API** for your own backend, on top of MCP
- 💬 **Works with any MCP client**: Claude Desktop, Cursor, VS Code, Cline, Continue

[Versão em português](README.pt.md) · [Full docs (PT-BR)](docs/) · [Agent skill](skills/)

---

## One-click install

### Claude (Web and Desktop)

Anthropic unified MCP installation at `claude.ai/customize/connectors`. **The same link works for Claude Web and Claude Desktop** (just be logged in):

[➕ Open in Claude and connect](https://claude.ai/new?modal=add-custom-connector#settings/customize-connectors)

**Manual** (if the deeplink does not open): [claude.ai/customize/connectors](https://claude.ai/customize/connectors?surface=cowork) → **+** → **Add custom connector** → paste **Name** `Instagram` and **URL** `https://api.mcp.ai/p_instagram`.

### Cursor

[➕ Install Instagram in Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=instagram&config=eyJ1cmwiOiJodHRwczovL2FwaS5tY3AuYWkvcF9pbnN0YWdyYW0ifQ==)

### VS Code (Copilot Chat)

[➕ Install Instagram in VS Code](vscode:mcp/install?name=instagram&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fapi.mcp.ai%2Fp_instagram%22%7D)

### ChatGPT, Manus, OpenClaw and 40+ other clients

Works with any MCP client that speaks **MCP over HTTP**. The server URL is always:

```
https://api.mcp.ai/p_instagram
```

Per-client details: [INSTALL.md](INSTALL.md).

---

## Example prompts

```
Publish this image on my Instagram with the caption "today's launch"
Which new comments came in on my last 3 posts?
Reply to that comment thanking them
What was the reach of my Reels last week?
Like this post: https://www.instagram.com/p/CxAbCdEfGhI/
Follow the profile nasa from my account
```

---

## 27 tools available

| Tool | Description |
|---|---|
| `instagram_actions_list_accounts` | List the Instagram accounts connected to this install — id, username, label. |
| `instagram_actions_like` | Like one or more Instagram posts, addressed by post URL or shortcode (NOT the numeric media id the official API returns). |
| `instagram_actions_list_comments` | List the comments on a post, addressed by URL or shortcode. |
| `instagram_actions_like_comment` | Like one or more comments. Each comment_id MUST come from instagram_actions_list_comments. The id returned by the official instagram_get_ig_media_comments belongs to a different namespace and is rejected. Returns a jo… |
| `instagram_actions_follow` | Follow one or more Instagram users by @username. |
| `instagram_actions_unfollow` | Unfollow one or more Instagram users by @username. |
| `instagram_actions_list_stories` | List a specific user's currently available stories (read-only, does not mark as seen). |
| `instagram_actions_view_story` | Watch (mark as seen) the stories of one or more profiles. |
| `instagram_actions_send_message` | Send the FIRST direct message to someone who has never messaged this account (the official API cannot do this). |
| `instagram_actions_get_job_status` | Get the status/progress/result of a previously started action by its job_id. |
| `instagram_actions_list_jobs` | List recent action jobs for the connected account, optionally filtered by status. |
| `instagram_get_user_info` | Get Instagram Business Account info including profile details and statistics. |
| `instagram_get_ig_user_media` | Get Instagram user's media collection (posts, photos, videos, reels, carousels). |
| `instagram_get_ig_media` | Get a published Instagram Media object (photo, video, story, reel, or carousel). |
| `instagram_get_ig_media_comments` | Tool to retrieve comments on an Instagram media object. |
| `instagram_get_ig_media_insights` | Tool to get insights and metrics for Instagram media objects (photos, videos, reels, carousel albums). |
| `instagram_get_user_insights` | Get Instagram account-level insights and analytics (profile views, reach, follower count, etc.). |
| `instagram_post_ig_user_media` | Tool to create a media container for Instagram posts. |
| `instagram_create_carousel_container` | Create a draft carousel post with multiple images/videos before publishing. |
| `instagram_post_ig_user_media_publish` | Tool to publish a media container to an Instagram Business account. |
| `instagram_post_ig_comment_replies` | Tool to create a reply to an Instagram comment. |
| `instagram_send_text_message` | Send a text message to an Instagram user via DM in an existing conversation. |
| `instagram_send_image` | Send an image via Instagram DM to a specific user. |
| `instagram_mark_seen` | Mark Instagram DM messages as read/seen for a specific user. |
| `instagram_get_conversation` | Get details about a specific Instagram DM conversation (participants, etc). |
| `instagram_list_all_conversations` | List all Instagram DM conversations for the authenticated user. |
| `instagram_list_all_messages` | List all messages from a specific Instagram DM conversation. |

Details for each tool: [docs/ferramentas.md](docs/ferramentas.md) (PT-BR)


---

## How it works

```
1. Install the MCP in your client (Claude / Cursor / VS Code)
2. Connect YOUR account:
   • Basic    — 2 clicks, Business or Creator account (official API)
   • Advanced — username and password, 2FA supported
3. Reading and publishing answer immediately (official API)
4. Engagement actions are queued and return a job id
5. instagram_actions_get_job_status follows each action to the end
```

**Engagement actions are asynchronous and run one at a time.** Each takes ~40 s
to ~2 min and the queue is serial, so this MCP is built to operate your account
at a human pace, not for volume. If you need reading/publishing at scale, use
the Basic plan, which is synchronous and free.

---

## Pricing

Billed per connected account. See [docs/precos.md](docs/precos.md) (PT-BR).

---

## Privacy & data protection

- **Sub-processors**: the LLM host you choose (Claude, ChatGPT, Cursor, your own agent). Full list in [docs/privacidade-lgpd.md](docs/privacidade-lgpd.md).
- Data returned by the tools is sent to **the LLM host you choose**, a sub-processor outside our control. We recommend plans with training opt-out.

---

## FAQ

**What is the difference between the Basic and Advanced plans?**
Basic is free, connects in 2 clicks and uses the official Instagram API (publishing, comments, DMs, insights). Advanced is a subscription per connected account and adds, on that same account, liking, following, unfollowing, listing/viewing stories and starting a DM conversation. Advanced also includes everything in Basic.

**Do I need a Business or Creator account?**
For the Basic plan yes, that is what the official API requires. The Advanced plan connects with username and password (2FA supported) and has no such requirement.

**How many actions per minute?**
Engagement actions are queued and executed one at a time, ~40 s to 2 min each. This MCP does not sell volume or bulk sending. Reading and publishing through the official API do not go through that queue.

**Does this touch other people's accounts?**
No. Every action happens on the account you connected, with your authorization, and each one returns an auditable job id. Use it within Instagram's Terms of Use.

**How do I like a post?**
Pass the post URL (https://www.instagram.com/p/… or /reel/…) or the shortcode. The numeric id the official API returns in `id` does not work for liking. If you listed media through the official side, use the `permalink` field.

**Is there a REST API besides MCP?**
Yes. The same tool set is mirrored over REST with a Bearer token, with OpenAPI and a skill markdown you can paste into your own agent. See docs/api-rest.md.

**Is the server open source?**
The server is proprietary (hosted). This repository is the public wrapper with manifests, docs and skills, all MIT.


---

## Support

- 📧 [instagram@mcp.ai](mailto:instagram@mcp.ai)
- 🐛 [GitHub Issues](https://github.com/mcp-dir/instagram-mcp/issues)
- 📄 [docs/](docs/)

---

## License

MIT — see [LICENSE](LICENSE). The MCP server at `api.mcp.ai/p_instagram` is proprietary (hosted); this repo (manifests, docs, skills) is MIT.