Insta

MCP server enabling AI assistants to interact with Instagram via the Model Context Protocol

typescript

1

GitHub Stars

typescript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "anand-kamble-mcp-instagram": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-instagram"
      ],
      "env": {
        "IG_PASSWORD": "your_instagram_password",
        "IG_USERNAME": "your_instagram_username"
      }
    }
  }
}

Insta MCP Server enables Instagram integration through the Model Context Protocol (MCP), letting you access profiles, timelines, stories, and post details, and perform engagement actions directly from MCP-compatible clients. It is designed to work with tools like Claude Desktop and Cursor IDE, providing secure login handling and a streamlined workflow for developers and power users.

How to use

You connect to Insta MCP Server from your MCP client to perform common Instagram actions. Start by authenticating with your Instagram credentials, then you can search for accounts, view profiles and feeds, retrieve posts and story data, and perform engagement actions such as liking, commenting, and following. Use the available tool endpoints to navigate content and manage your Instagram presence programmatically.

Authenticate to Instagram using instagram_login and, if prompted, complete two-factor authentication with instagram_complete_2fa.
Retrieve the authenticated user’s profile with instagram_get_current_user_profile.
Search for accounts with instagram_search_accounts and fetch user details with instagram_get_user_profile.
Get a user’s posts via instagram_get_user_posts and drill into details with instagram_get_post_details.
Fetch active stories using instagram_get_user_stories and the home/timeline feed with instagram_get_timeline_feed.
Like posts or comments with instagram_like_post and instagram_like_comment.
Add comments with instagram_comment_on_post and review post comments via instagram_get_post_comments.
Follow users using instagram_follow_user to grow your network.

Security and authentication

Credentials are provided to the server through environment variables in your MCP client configuration. If 2FA is enabled on your account, complete the flow using the instagram_complete_2fa tool after the initial login.

Verification and troubleshooting

After starting the server in your MCP client, verify it appears in the list of available servers and test authentication followed by a simple data request such as fetching your own profile or performing a small search to confirm connectivity.

Available tools

instagram_login

Initiates login to the Instagram account using provided credentials and establishes a session for subsequent requests.

instagram_complete_2fa

Completes the two-factor authentication flow if 2FA is enabled on the account.

instagram_logout

Ends the current Instagram session.

instagram_search_accounts

Search for Instagram accounts by name or keyword to discover profiles.

instagram_get_user_profile

Fetches detailed information for a specific user by ID or username.

instagram_get_current_user_profile

Retrieves the authenticated user’s own profile data.

instagram_get_user_posts

Retrieves a paginated list of posts from a specified user.

instagram_get_post_details

Gets comprehensive information about a specific post or reel.

instagram_get_user_stories

Gets active stories from a user.

instagram_get_timeline_feed

Fetches the home feed with posts from accounts you follow.

instagram_like_post

Likes a post or reel on behalf of the authenticated user.

instagram_like_comment

Likes a comment on a post.

instagram_comment_on_post

Adds a comment to a post or replies to an existing comment.

instagram_get_post_comments

Retrieves comments for a specific post.

instagram_follow_user

Follows a specified Instagram user.