
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 toolsPublic 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:9222Chrome DevTools Protocol URL of a Chrome window already signed in to Instagram.
IG_DRY_RUNdefault: trueWhen 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.
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:
Details
- Repository
- github.com/fanyzp/unofficial-instagram-mcp
- Categories
- Web & Browser Automation, Media & Entertainment
- Package
unofficial-instagram-mcp- Transport
- STDIO
- Registry
- MCP registry, active