これはInstagramダイレクトメッセージを送信するためのモデルコンテキストプロトコル(MCP)サーバーです。

これを使うとアカウントからInstagramのダイレクトメッセージを送ることができます(今後さらに多くの機能が登場予定です)。

Claudeに接続した場合にできることの例を紹介します。

https://github.com/user-attachments/assets/9c945f25-4484-4223-8d6b-5bf31243464c

このプロジェクトや他のプロジェクトの最新情報を受け取りたい方は、こちらからメールアドレスを入力してください

---

設置

前提条件

• Python 3.11+
• Anthropic Claude デスクトップアプリ(またはカーソル)
• Pip(Pythonパッケージマネージャー)、[[T1]でインストール)
• インスタグラムアカウント

ステップス

1. このリポジトリをクローン

2. 依存関係をインストールする

• UVの使用(推奨):

• Pipの利用:

3. Instagramの認証情報を設定する

Instagramの認証情報を提供する方法は2つあります:

オプションA:環境変数(推奨)

簡単なセットアップ(推奨):

ヘルパースクリプトを実行します:

これにより、認証情報の入力がインタラクティブに促され、.envファイルが安全に作成されます。

手動セットアップ:

プロジェクトのルートに.envファイルを作成します:

その後、実際の資格情報で.envを編集してください:

Instagram DM MCP server

This is a Model Context Protocol (MCP) server for sending instagram Direct Messages.

With this you can send Instagram Direct Messages from your account (more capabilities coming soon).

Here’s an example of what you can do when it’s connected to Claude.

https://github.com/user-attachments/assets/9c945f25-4484-4223-8d6b-5bf31243464c

To get updates on this and other projects we work on enter your email here

---

Installation

Prerequisites

• Python 3.11+
• Anthropic Claude Desktop app (or Cursor)
• Pip (Python package manager), install with python -m pip install
• An instagram account

Steps

1. Clone this repository

   git clone https://github.com/trypeggy/instagram_dm_mcp.git
   cd instagram_dm_mcp
   

2. Install dependencies

• Using uv (recommended):

  uv sync
  

• Using Pip:

  pip install -r requirements.txt
  

3. Configure Instagram credentials

   You have two options for providing your Instagram credentials:

   Option A: Environment Variables (Recommended)

   Quick Setup (Recommended):

   Run the helper script:

   python setup_env.py
   

   This will interactively prompt you for your credentials and create the .env file securely.

   Manual Setup:

   Create a .env file in the project root:

   cp env.example .env
   

   Then edit .env with your actual credentials:

   INSTAGRAM_USERNAME=your_instagram_username
   INSTAGRAM_PASSWORD=your_instagram_password
   

   Option B: Command Line Arguments

   You can still pass credentials as command line arguments (less secure).

4. Connect to the MCP server

   For Claude Desktop:

   Save this as claude_desktop_config.json in your Claude Desktop configuration directory at:

   ~/Library/Application Support/Claude/claude_desktop_config.json
   

   For Cursor:

   Save this as mcp.json in your Cursor configuration directory at:

   ~/.cursor/mcp.json
   

   Configuration with Environment Variables (Recommended):

   • Using uv

   {
     "mcpServers": {
       "instagram_dms": {
           "command": "uv",
           "args": [
             "run",
             "--directory",
             "PATH/TO/instagram_dm_mcp",
             "python",
             "src/mcp_server.py"
           ]
        }
      }
    }
   

   • Using Python

   {
     "mcpServers": {
       "instagram_dms": {
         "command": "python",
         "args": [
           "{{PATH_TO_SRC}}/instagram_dm_mcp/src/ mcp_server.py"
         ]
       }
     }
   }
   

   Configuration with Command Line Arguments:

   {
     "mcpServers": {
       "instagram_dms": {
         "command": "python",
         "args": [
           "{{PATH_TO_SRC}}/instagram_dm_mcp/src/mcp_server.py",