Instagram

Provides access to Instagram user data, posts, reels, and search via MCP for Claude Desktop integration.

python

0

GitHub Stars

python

Language

5 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": {
    "readify-app-insta-mcp-server": {
      "command": "uv",
      "args": [
        "run",
        "insta-mcp-server"
      ],
      "env": {
        "ENSEMBLEDATA_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

You can run a dedicated MCP (Model Context Protocol) server that fetches Instagram data through EnsembleData and makes it available to your MCP clients. This server lets you retrieve user info, posts, reels, search Instagram content, and get post details and follower counts, all through a configurable local service that you can connect to Claude Desktop or other MCP clients.

How to use

Start the local MCP server and connect it to your MCP client to begin querying Instagram data. You will access endpoints by using the MCP client to send requests for user information, user posts, stats, reels, searches, and post details. Typical usage patterns include fetching a user’s profile, listing the latest posts, pulling reels, performing keyword or tag searches, and retrieving exact post information with comments.

How to install

Prerequisites you need before installation are Python 3.10 or newer, Claude Desktop installed, and an active internet connection.

Automatic installation (recommended) on macOS / Linux:

curl -sSf https://raw.githubusercontent.com/Readify-App/insta-mcp-server/main/install.sh | bash

Or clone the repository and run the installer:

git clone https://github.com/Readify-App/insta-mcp-server.git
cd insta-mcp-server
chmod +x install.sh
./install.sh

Automatic installation on Windows (PowerShell):

irm https://raw.githubusercontent.com/Readify-App/insta-mcp-server/main/install.ps1 | iex

Or clone the repository and run the installer from the cloned directory:

git clone https://github.com/Readify-App/insta-mcp-server.git
cd insta-mcp-server
.\install.ps1

Manual installation steps you can follow if you prefer to set things up yourself:

git clone https://github.com/Readify-App/insta-mcp-server.git
cd insta-mcp-server
uv sync

Configure Claude Desktop to run the MCP server automatically by updating claude_desktop_config.json with the following entry. Adjust the path to your actual insta-mcp-server location.

{
  "mcpServers": {
    "insta_mcp_server": {
      "command": "uv",
      "args": ["--directory", "/path/to/insta-mcp-server", "run", "insta-mcp-server"]
    }
  }
}

Available tools

instagram_user_info

Fetches basic user information for a given Instagram username.

instagram_user_posts

Retrieves a list of posts for a given Instagram username, with an optional count.

instagram_user_stats

Gets statistics for a specified Instagram user.

instagram_user_reels

Obtains a user's reels (short video posts) with a configurable count.

instagram_search

Searches for users, hashtags, or places based on a query.

instagram_post_info

Retrieves detailed information and comments for a specific Instagram post URL.

instagram_follower_count

Returns the follower count for a given Instagram username.