Instagram DM Server for AI Assistants

⚡ はじめに

60 秒以内で使い始められます。

1. MCP の設定に追加します（Claude Desktop、Claude Code、または Cursor）：

{
  "mcpServers": {
    "instagram": {
      "command": "npx",
      "args": ["-y", "mcp-instagram-dm"],
      "env": {
        "INSTAGRAM_SESSION_ID": "your_session_id",
        "INSTAGRAM_CSRF_TOKEN": "your_csrf_token",
        "INSTAGRAM_DS_USER_ID": "your_user_id"
      }
    }
  }
}

2. AI アシスタントに話しかけます：

「Instagram の DM を読んで」

これで準備完了です。🎉

Cookie の取得方法については、以下の設定をご覧ください。

🎬 使用イメージ

You:    "Show me my unread Instagram DMs"
Claude: Fetching your inbox...

        📬 Inbox (3 conversations)

        [UNREAD] john_doe (thread_id: 340282366841710300...)
          Last: [2026-03-29 14:23:01] john_doe: Hey, are you free tonight?

        [UNREAD] [GROUP] project_team (thread_id: 340282366841710301...)
          Last: [2026-03-29 13:45:22] alice: Meeting moved to 3pm

        jane_smith (thread_id: 340282366841710302...)
          Last: [2026-03-29 10:12:45] You: Thanks! See you then

You:    "Reply to john_doe: Yeah, let's meet at 7!"
Claude: ✅ Message sent: "Yeah, let's meet at 7!"

✨ 機能

3 つのカテゴリにわたる15 個のツールで、Instagram の DM を管理するために必要なすべての機能を利用できます。

📥 読み取りとモニタリング

✏️ 送信と管理

🔍 検索と発見

📦 インストール

npx（推奨 — インストール不要）

npx mcp-instagram-dm

npm グローバルインストール

npm install -g mcp-instagram-dm
mcp-instagram-dm

ソースからインストール

git clone https://github.com/KynuxDev/mcp-instagram-dm.git
cd mcp-instagram-dm
npm install && npm run build
node dist/index.js

🔧 設定

Cookie の取得

1. Chrome で instagram.com を開いてログインします
2. F12 を押し、Application タブ → Cookies → https://www.instagram.com の順に開きます
3. 次の 3 つの値をコピーします：

💡 ヒント： node get-cookies.js を実行して、手順に沿って取得することもできます。

環境変数

クライアントのセットアップ

{
  "mcpServers": {
    "instagram": {
      "command": "npx",
      "args": ["-y", "mcp-instagram-dm"],
      "env": {
        "INSTAGRAM_SESSION_ID": "your_session_id",
        "INSTAGRAM_CSRF_TOKEN": "your_csrf_token",
        "INSTAGRAM_DS_USER_ID": "your_user_id"
      }
    }
  }
}

{
  "mcpServers": {
    "instagram": {
      "command": "npx",
      "args": ["-y", "mcp-instagram-dm"],
      "env": {
        "INSTAGRAM_SESSION_ID": "your_session_id",
        "INSTAGRAM_CSRF_TOKEN": "your_csrf_token",
        "INSTAGRAM_DS_USER_ID": "your_user_id"
      }
    }
  }
}

{
  "mcpServers": {
    "instagram": {
      "command": "npx",
      "args": ["-y", "mcp-instagram-dm"],
      "env": {
        "INSTAGRAM_SESSION_ID": "your_session_id",
        "INSTAGRAM_CSRF_TOKEN": "your_csrf_token",
        "INSTAGRAM_DS_USER_ID": "your_user_id"
      }
    }
  }
}

💬 使用例

AI アシスタントに自然な言葉で話しかけるだけです：

📖 ツールリファレンス

🏗️ アーキテクチャ

┌─────────────────────┐     MCP (stdio)     ┌──────────────────────┐
│   AI Assistant       │◄──────────────────►│   MCP Server          │
│   (Claude, Cursor)   │                     │   src/index.ts        │
└─────────────────────┘                     │   15 tools            │
                                             └──────────┬───────────┘
                                                        │
                                             ┌──────────▼───────────┐
                                             │   Instagram Client    │
                                             │   src/instagram.ts    │
                                             │   Cookie auth + HTTP  │
                                             └──────────┬───────────┘
                                                        │
                                             ┌──────────▼───────────┐
                                             │   Instagram Web API   │
                                             │   (Private endpoints) │
                                             └──────────────────────┘

設計原則：

• 依存関係は 1 つのみ — @modelcontextprotocol/sdk のみを使用します。axios も puppeteer もなく、余計なものはありません。
• TypeScript の厳格モード — any 型はゼロで、src/types.ts のインターフェースは完全に型付けされています
• ページネーションの自動処理 — 500 件のメッセージをリクエストすると、サーバーがレート制限を適用しながら残りを処理します
• 14 種類以上のメッセージタイプ — テキスト、メディア、音声、リール、リンク、クリップ、GIF、投稿、ストーリーなど

🔒 セキュリティ

• セッション Cookie がランタイム終了後にログへ記録されたり、保存されたりすることはありません
• すべての認証情報は環境変数からのみ読み込まれます
• データがサードパーティのサービスに送信されることはありません
• 脆弱性の報告については、SECURITY.md をご覧ください

⚠️ 免責事項

このプロジェクトでは Instagram の非公式ウェブ API を使用しているため、予告なく変更される場合があります。

• 個人利用のみ — スパム、大量メッセージ送信、または Instagram の利用規約に違反する自動化には使用しないでください
• セッション Cookie は機密性の高い認証情報です — 決して共有したり、コミットしたりしないでください
• このプロジェクトは Meta または Instagram とは提携、承認、関係していません
• ご自身の責任でご利用ください — アカウント制限について、作者は一切責任を負いません

🤝 コントリビューション

コントリビューションを歓迎します！開発環境のセットアップとガイドラインについては、CONTRIBUTING.md をご覧ください。

プロジェクトを金銭的に支援したい場合は、GitHub でスポンサーになることをご検討ください。

📄 ライセンス

MIT — Kynux が ❤️ を込めて作成