Skip to content
Back to search

instagram-reels-mcp

MCP server to publish Instagram Reels from local files via the official Graph API, with scheduled 3-a-day posting. Includes a step-by-step setup tutorial.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/mauryavikash917--instagram-reels-mcp/badge.svg)](/listings/mauryavikash917--instagram-reels-mcp)

HTML

<a href="/listings/mauryavikash917--instagram-reels-mcp"><img src="/api/listings/mauryavikash917--instagram-reels-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

python3 -m venv .venv && .venv/bin/pip install -r requirements.txt
brew install cloudflared                  # macOS; see TUTORIAL.md for Linux
examples/save-token.sh                    # saves your Meta token without showing it
IG_USER_ID=17841XXXXXXXXXXXX .venv/bin/python server.py --check
claude mcp add instagram --scope local -e IG_USER_ID=17841XXXXXXXXXXXX -- \
  "$PWD/.venv/bin/python" "$PWD/server.py"

Getting the token and the account id takes some clicking on Meta's sites: **follow [TUTORIAL.md](TUTORIAL.md)** step by step. Using Claude Code? Open this folder and ask it to set things up; [CLAUDE.md](CLAUDE.md) tells it how.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 62 lines
  1. # Instagram Reels MCP
  2. An MCP server that lets Claude (or any MCP client) **publish Reels** from files on your computer
  3. and **read your Instagram account**, through Meta's official Instagram Graph API. Plus an
  4. optional timer script that posts a list of Reels on a schedule (e.g. 3 a day).
  5. - No third-party posting service, no browser automation, no password sharing.
  6. - Uses a Meta **system-user token** that never expires, stored in a private file.
  7. - Your video never needs to be hosted anywhere: a temporary Cloudflare link opens for that one
  8. file while Instagram fetches it, then closes.
  9. ## Tools
  10. | Tool | What it does |
  11. |---|---|
  12. | `account_info` | Username, post count, followers. |
  13. | `list_media(limit)` | Your latest posts with caption, link and time. |
  14. | `publish_reel(file_path, caption, share_to_feed=True)` | Publishes a local MP4/MOV as a Reel now. Takes 3-6 minutes. |
  15. ## Quick start
  16. ```bash
  17. python3 -m venv .venv && .venv/bin/pip install -r requirements.txt
  18. brew install cloudflared # macOS; see TUTORIAL.md for Linux
  19. examples/save-token.sh # saves your Meta token without showing it
  20. IG_USER_ID=17841XXXXXXXXXXXX .venv/bin/python server.py --check
  21. claude mcp add instagram --scope local -e IG_USER_ID=17841XXXXXXXXXXXX -- \
  22. "$PWD/.venv/bin/python" "$PWD/server.py"
  23. ```
  24. Getting the token and the account id takes some clicking on Meta's sites:
  25. **follow [TUTORIAL.md](TUTORIAL.md)** step by step. Using Claude Code? Open this folder and ask
  26. it to set things up; [CLAUDE.md](CLAUDE.md) tells it how.
  27. ## Files
  28. | File | Purpose |
  29. |---|---|
  30. | `server.py` | The MCP server. `--check` runs a read-only live test. |
  31. | `post_next.py` | Posts the next Reel from `schedule.json`. `--dry-run`, `--selftest`. |
  32. | `schedule.example.json` | Format of the posting list. |
  33. | `examples/save-token.sh` | Saves the token through a hidden field. |
  34. | `examples/com.example.instagram-post.plist` | macOS timer for 12:00, 18:00, 21:00. |
  35. ## Settings
  36. | Variable | Default | Meaning |
  37. |---|---|---|
  38. | `IG_USER_ID` | (required) | Instagram account id, starts with `17841`. |
  39. | `IG_TOKEN_FILE` | `~/.config/instagram-mcp/token` | File holding the system-user token. |
  40. | `IG_SCHEDULE` | `schedule.json` next to the scripts | Posting list for `post_next.py`. |
  41. ## Requirements
  42. Python 3.10+, `cloudflared`, an Instagram professional account in a Meta business portfolio, and
  43. a Meta app with `instagram_basic` + `instagram_content_publish`. API limit: 100 posts per 24 h.
  44. Only post videos you have the rights to.
  45. ## License
  46. MIT, see [LICENSE](LICENSE).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.