fanyzp avatar

Unofficial Instagram MCP

fanyzp/unofficial-instagram-mcp

Instagram for AI agents via signed-in Chrome: DMs, profiles, posts and stories.

tools
36
transport
STDIO
env vars
2
last updated
Nov 17, 2026

Tools

36 tools

Public tool metadata for what this MCP can expose to an agent.

ig_statusCheck the browser connection and the signed-in account.

Check the browser connection and the signed-in account.

No parameter schema in public metadata yet.

ig_selftestRun the built-in self-test. The safe level only reads; the full level tests every write function and deletes its own test content.

Run the built-in self-test. The safe level only reads; the full level tests every write function and deletes its own test content.

No parameter schema in public metadata yet.

dm_list_threadsList recent DM threads. Opening a thread can mark it as read.

List recent DM threads. Opening a thread can mark it as read.

No parameter schema in public metadata yet.

dm_checkFind threads where the latest message came from the other person.

Find threads where the latest message came from the other person.

No parameter schema in public metadata yet.

dm_read_threadRead the latest messages in one thread.

Read the latest messages in one thread.

No parameter schema in public metadata yet.

dm_sendSend a message in an existing thread.

Send a message in an existing thread.

No parameter schema in public metadata yet.

dm_send_to_userSend a message to a user by username.

Send a message to a user by username.

No parameter schema in public metadata yet.

dm_watchStart, stop, or check the DM watcher that monitors the inbox in the background.

Start, stop, or check the DM watcher that monitors the inbox in the background.

No parameter schema in public metadata yet.

dm_eventsRead watcher events (verified new messages and watcher state changes) since a cursor.

Read watcher events (verified new messages and watcher state changes) since a cursor.

No parameter schema in public metadata yet.

notifications_listRead recent likes, comments, follows, and mentions.

Read recent likes, comments, follows, and mentions.

No parameter schema in public metadata yet.

profile_getRead a profile, including counts and bio text.

Read a profile, including counts and bio text.

No parameter schema in public metadata yet.

searchSearch from a keyword and return matching users, hashtags, posts, and reels shown by Instagram.

Search from a keyword and return matching users, hashtags, posts, and reels shown by Instagram.

No parameter schema in public metadata yet.

followers_listList followers for a profile.

List followers for a profile.

No parameter schema in public metadata yet.

following_listList accounts followed by a profile.

List accounts followed by a profile.

No parameter schema in public metadata yet.

user_followFollow a user.

Follow a user.

No parameter schema in public metadata yet.

user_unfollowUnfollow a user.

Unfollow a user.

No parameter schema in public metadata yet.

user_postsList recent posts and reels from a profile.

List recent posts and reels from a profile.

No parameter schema in public metadata yet.

post_getRead the author, time, media type, caption, and visible page text for a post.

Read the author, time, media type, caption, and visible page text for a post.

No parameter schema in public metadata yet.

post_commentsRead comments on a post.

Read comments on a post.

No parameter schema in public metadata yet.

feed_homeRead recent posts from the home feed.

Read recent posts from the home feed.

No parameter schema in public metadata yet.

explore_postsList posts from the Explore page.

List posts from the Explore page.

No parameter schema in public metadata yet.

hashtag_postsList posts from a hashtag page.

List posts from a hashtag page.

No parameter schema in public metadata yet.

media_urlsReturn the image and video URLs used by a post.

Return the image and video URLs used by a post.

No parameter schema in public metadata yet.

stories_trayList accounts with an active story in the home tray.

List accounts with an active story in the home tray.

No parameter schema in public metadata yet.

story_viewOpen a user story. Viewing it marks the story as seen.

Open a user story. Viewing it marks the story as seen.

No parameter schema in public metadata yet.

post_createCreate a post from local image files and a caption.

Create a post from local image files and a caption.

No parameter schema in public metadata yet.

post_likeLike a post or reel. Safe to call again if it is already liked.

Like a post or reel. Safe to call again if it is already liked.

No parameter schema in public metadata yet.

post_commentAdd a comment to a post or reel.

Add a comment to a post or reel.

No parameter schema in public metadata yet.

post_reply_to_commentReply to one comment that matches the supplied text.

Reply to one comment that matches the supplied text.

No parameter schema in public metadata yet.

comment_likeLike one comment that matches the supplied text.

Like one comment that matches the supplied text.

No parameter schema in public metadata yet.

post_saveSave a post. Safe to call again if it is already saved.

Save a post. Safe to call again if it is already saved.

No parameter schema in public metadata yet.

post_deleteDelete one of your own posts by URL. Refuses posts owned by someone else.

Delete one of your own posts by URL. Refuses posts owned by someone else.

No parameter schema in public metadata yet.

story_replyReply to a user story. The reply is delivered as a direct message.

Reply to a user story. The reply is delivered as a direct message.

No parameter schema in public metadata yet.

story_createCreate a story from an image file, or a text story when the web text editor is available. Not offered by Instagram Web for every account; see docs/VERIFICATION.md.

Create a story from an image file, or a text story when the web text editor is available. Not offered by Instagram Web for every account; see docs/VERIFICATION.md.

No parameter schema in public metadata yet.

story_create_pollCreate a story with a poll sticker: a question and two options, on an image. Subject to the same Instagram Web limitation as `story_create`.

Create a story with a poll sticker: a question and two options, on an image. Subject to the same Instagram Web limitation as `story_create`.

No parameter schema in public metadata yet.

story_deleteDelete your own currently active story.

Delete your own currently active story.

No parameter schema in public metadata yet.

Sponsors

Configuration

CDP_URLdefault: http://127.0.0.1:9222

Chrome DevTools Protocol URL of a Chrome window already signed in to Instagram.

IG_DRY_RUNdefault: true

When true, write tools simulate the action without completing it. Keep true while testing.

Readme

unofficial-instagram-mcp

unofficial-instagram-mcp

Instagram, now accessible to your AI agent.

Listed on mcpservers.org

An unofficial Model Context Protocol (MCP) server for Instagram Web. It gives an AI agent a set of focused tools for messages, profiles, posts, comments, stories, and notifications.

The server connects to a Chrome window that is already signed in to Instagram. It does not use the Meta API, and it does not ask for or store an Instagram password.

Quick start (no clone needed)

One command installs everything into your agent: it registers the MCP server and installs the Agent Skill. Pick your harness in the menu.

npx github:fanyzp/unofficial-instagram-mcp install

Or register the server in your MCP client config and let it run through npx directly:


View the full README on GitHub

Details

Repository
github.com/fanyzp/unofficial-instagram-mcp
Categories
Web & Browser Automation, Media & Entertainment
Package
unofficial-instagram-mcp
Transport
STDIO
Registry
MCP registry, active

More from fanyzp

Related Web & Browser Automation MCP servers

View all
1felixlin789 avatarWebShellfelixlin789/webshellDrive a real browser with shell-like text commands (cd/ls/cat/click/type), using far fewer tokens.0stars
2hayodev avatarCrystallize MCPhayodev/crystallize-mcpCrystallize headless commerce tools for AI agents via Model Context Protocol0stars
3hj1003862396 avatarDraw Flow Mcp Serverhj1003862396/draw-flow-mcp-serverMCP server for Next AI Draw.io - AI-powered diagram generation with real-time browser preview0stars
4br0ski777 avatarUser Agent Parser APIbr0ski777/user-agent-parser-x402Parse user agents — browser, OS, device, bot detection. x402 micropayment.0stars
5jsvvsolsllc avatarMiOffice — AI-Powered Workspace Studioio.github.jsvvsolsllc/mioffice125+ browser tools for PDF, Image, Video, Audio, AI, Scanner. Files never leave your device.0stars
6mukundakatta avatarHtml To Markdown Mcpmukundakatta/mcp-stackConvert HTML to Markdown or strip to plain text. For web-scraping agents.0stars