MCP / Instagram DMs / Gemini CLI

How to connect Instagram DMs to Gemini CLI with Winly MCP

Connect Gemini CLI to your Instagram DMs. Find leads who went quiet, draft replies, tag contacts and pull sales reports in plain words. Winly handles the sign-in with Meta for you.

Setup from Gemini CLI's docs. Sources below the steps.

On this page

Introduction

Work your Instagram DMs from Gemini CLI. You don't need a Meta developer app or any code. You add one Winly server to Gemini CLI, sign in to Winly and ask in plain words.

For the name and inputs of every tool, see the Winly docs.

For sales teams. Winly also has tools for follower lead scores, ad attribution, keyword reports, VIP lists and assigning leads in bulk. They work on every plan. Want a walkthrough for your team? See a Demo.

Also connect Instagram DMs to

Why use Winly?

  • One server URL connects your Instagram and Facebook DMs to Gemini CLI.
  • Meta's official API. No shared passwords and no browser cookies.
  • A sales pipeline underneath. Gemini CLI gets stages, tags, owners and reports along with your messages.
  • You choose who presses send. Gemini CLI can draft replies for you to approve, or reply for you. You set this in Gemini CLI.

Connecting Instagram DMs to Gemini CLI using Winly

What you need

  • A Winly account. The free plan works.
  • An Instagram professional account (Business or Creator) or a Facebook Page.
  • Gemini CLI on a Google plan that still includes it. Google's docs say unpaid tier and Google One users moved to Antigravity CLI on June 18, 2026.
  • A web browser on the same computer. Google's docs say sign-in won't work over SSH without one, or in a container.

Copy this command and run it in your terminal.

Terminal
gemini mcp add --transport http -s user winly https://app.sbccrm.com/bld/api/mcp

The server URL on its own:

Server URL
https://app.sbccrm.com/bld/api/mcp

Then follow the steps below.

What is the Instagram DM MCP server, and what's possible with it?

The Winly MCP server connects AI agents like Gemini CLI to your own Instagram and Facebook inbox. Gemini CLI can read your chats, contacts and reports, answer questions and do the follow-up work you ask for.

  • Inbox: list open chats, search what people said, and read one lead's history.
  • Replies: send text to people who messaged you first, up to 7 days after their last message or reaction. Images, video and audio go out only within 24 hours of the person's last message.
  • Pipeline: add tags, change stages, set owners and save notes.
  • Reports: quiet leads, reply speed, reply rate, drop-off and the messages that get replies.
  • Comments: read comments on your Instagram posts and Facebook Page posts, reply, hide or delete. One private reply per comment, within 7 days.
  • Autopilot: review Autopilot's rules, saved knowledge and chats, and add rules or fixes. These tools need Autopilot on in your workspace.

You can send text up to 7 days after the person's last message or reaction. Images, video and audio can go out up to 24 hours after their last message. Winly blocks anything later.

Step-by-step guide

Step by step7 steps
  1. Create a free Winly account

    Go to the Winly signup and choose the Free plan. It's $0 with 300 credits a month and 2 connected accounts. No card needed.

    Signup link
    https://app.sbccrm.com/mcp/signup
  2. Connect Instagram or Facebook

    In Winly, connect an Instagram professional account (Business or Creator) or a Facebook Page. Winly connects through Meta's official API.

  3. Add the Winly server

    Run this in your terminal. The -s user flag saves Winly to ~/.gemini/settings.json so it works in every project.

    Terminal
    gemini mcp add --transport http -s user winly https://app.sbccrm.com/bld/api/mcp
  4. Start the sign-in

    Open Gemini CLI and run /mcp auth winly.

    Gemini CLI
    /mcp auth winly
  5. Sign in to Winly and approve

    Your browser opens the Winly sign-in page. Sign in to Winly and approve.

  6. Check the connection

    Run /mcp list in Gemini CLI. Winly should show as CONNECTED.

    Gemini CLI
    /mcp list
  7. Ask a first question

    In Gemini CLI, ask something like "Which leads haven't replied this week?" Lookups of 25 results or fewer cost 0 credits.

Setup from Gemini CLI's docs, read Nov 19, 2026: MCP servers with Gemini CLI | Gemini CLI.

Things to ask

  • "Which leads haven't replied this week?"
  • "Show me new Instagram DMs from today that still need a reply."
  • "Draft a reply to my newest Facebook message. Don't send it yet."
  • "Tag everyone who asked about prices in my post comments as hot lead."

If it won't connect

  • Winly shows as DISCONNECTED. Run /mcp list to see the error. Check the URL is exactly the Winly URL with no typos.
  • Sign-in won't start over SSH or in a container. Gemini CLI needs a browser on the same computer for sign-in. Run the sign-in on a computer with a browser.
  • Winly worked before and now asks you to sign in. Your login expired. Run /mcp auth winly again.
  • You need more detail on an error. Start Gemini CLI with --debug and try again.
  • Gemini CLI says to use Antigravity CLI. Google moved unpaid tier and Google One users to Antigravity CLI on June 18, 2026. You'll need a plan that still includes Gemini CLI.

Supported tools

Every tool Gemini CLI gets when you connect Winly. All 52 tools are on every plan. Autopilot tools need Autopilot on in your workspace. Tools marked Admins only need a Winly admin sign-in. A lookup of 25 results or fewer costs 0 credits, and a bigger list costs 2 or more.

Tools 52
List Inbox Conversations

Lists inbox conversations, newest first, by status, channel or owner.

0 credits up to 25 results
Search Conversations

Finds contacts whose saved conversation snippets match words you give it.

0 credits up to 25 results
Ask About Contact

Gets one contact's details, notes, tags, stage and message history.

0 credits up to 25 results
List Contacts

Lists contacts with owner, tags, status and dates, with filters.

0 credits up to 25 results
Search Contacts

Finds contacts by part of a username, a name or a phone number.

0 credits up to 25 results
Get Contact Activities

Shows a contact's activity log, like messages, tag changes and owner changes.

0 credits up to 25 results
Get Contact Tag Assignments

Shows when each tag a contact has now was added.

0 credits up to 25 results
List Users

Finds people in your workspace who can be given contacts.

0 credits up to 25 results
Send DM

Sends a text, image, video or audio DM to a contact who messaged you first.

2 credits
Upload Media

Gets an image, video or audio file ready to send with send_dm. It sends nothing.

0 credits
React To Message

Adds or removes a heart reaction on a DM a contact sent you.

1 credit
Add Tag

Adds one of your existing tags to a contact.

1 credit
Remove Tag

Takes a tag off a contact.

1 credit
Set Contact Status

Marks a conversation open, closed or spam. You can change it back.

1 credit
Assign Contact Owner

Gives a contact to a different person on your team.

1 credit
Update Contact Notes

Replaces the notes on a contact with new text.

1 credit
Get Lead Summary

Sums up your whole pipeline for a date range: stage counts, conversion and new leads.

0 credits up to 25 results
Get Stale Leads

Finds leads you messaged last who haven't replied yet.

0 credits up to 25 results
Get Pipeline Leaks

Finds leads stuck at a stage with no recent messages, by stage and rep.

0 credits up to 25 results
Get Response Rate

Shows how often leads reply to your messages, by day and by rep.

0 credits up to 25 results
Get Speed To Lead

Shows how fast your reps answer a lead's first message.

0 credits up to 25 results
Get Followup Performance

Shows which follow-up, first, second or third, gets the most replies.

0 credits up to 25 results
Get Message Leaderboard

Ranks the messages you send by how often they get a reply.

0 credits up to 25 results
Get Conversion Messages

Compares messages sent to leads who moved to the next stage and leads who didn't.

0 credits up to 25 results
Get Rep Performance

Shows each rep's chats, replies, wins, losses, revenue and speed.

0 credits up to 25 results
Get Pipeline Forecast

Estimates revenue from payment links you sent, using each rep's past close rate.

0 credits up to 25 results
Get ICP Data

Looks at the leads you won to show what your best buyers have in common.

0 credits up to 25 results
Get Posts

Lists posts from your connected Instagram account or Facebook Page.

0 credits up to 25 results
Get Comments

Reads comments and replies on one of your Instagram or Facebook posts, or finds unanswered ones.

0 credits up to 25 results
Reply To Comment

Replies to an Instagram or Facebook comment in public, or sends one private DM reply to it.

1 credit, or 2 if private
Moderate Comment

Hides, unhides or deletes a comment. Likes Facebook comments too.

1 credit
Get Workflows

Lists your workflows or shows one in detail. Admins only.

0 credits up to 25 results
Configure Workflow

Builds a paused workflow from one of two templates. Admins only.

0 to preview, 1 to save
Set Workflow Status

Turns a workflow made from a template on or off. Admins only.

1 credit
Get Credit Balance

Shows your credits left, this month's use and what you can buy. Admins only.

0 credits
Quote Credit Purchase

Prices a credit pack before you buy. It doesn't charge you. Admins only.

0 credits
Create Credit Checkout

Makes a secure checkout link for a credit quote you approved. Admins only.

0 credits
Get Follower Lead Score Report

Reports how many of your followers were scored as likely leads, by day.

0 credits up to 25 results
Get Ad Attribution

Lists conversations that started from an ad, or exports them as a CSV file.

0 credits up to 25 results
Import Ad Attribution

Matches lead form rows you give it to your DMs, after you approve. Admins only.

1 or more credits
Manage Keyword Report

Tracks keywords and shows which leads used them and what happened next.

1 or more credits
Manage VIP List

Keeps a VIP list and pings your webhook when a VIP sends you a message.

1 or more credits
Assign Contact Batch

Gives a previewed batch of up to 100 contacts to one person on your team.

1 or more credits
Review Autopilot Prompt

Shows the rules, fixes and tone Autopilot uses, and how many saved entries it has.

0 credits up to 25 results
Review Conversations

Lists recent chats Autopilot handled, with their stage and latest messages.

0 credits up to 25 results
Review Learning Candidates

Lists chats saved as good examples for Autopilot. You approve or reject each one.

0 credits up to 25 results
Store Knowledge

Saves text or a document (PDF, DOCX or TXT) for Autopilot to use in chats.

1 credit
Take Over From Autopilot

Takes a chat back from Autopilot so a person on your team handles it.

1 credit
Update Sales Rules

Adds a sales rule for Autopilot, like a booking link, and flags rules that clash.

1 credit
Give Conversation Feedback

Saves a fix for an Autopilot message. It doesn't change or resend the message.

1 credit
Get Memory

Lists the rules, fixes, tone and knowledge Autopilot uses, up to 200 at a time.

0 credits up to 25 results
Delete Memory

Turns off one saved rule, fix or knowledge entry so Autopilot stops using it.

1 credit

Autopilot and memory. These tools work with Autopilot, the AI reply feature in the Winly app. They need Autopilot to be on in your workspace, and you turn it on in the Winly app. No tool turns it on from an AI agent, and workspaces that use Winly only through MCP can't turn it on.

How to connect Instagram DMs to another AI agent

Explore other Winly MCP servers

Messenger DMs

Read and answer your Facebook Page's Messenger chats.

51 toolsOAuth
Open
Instagram Comments

Read, reply to and hide comments on your posts.

10 toolsOAuth
Open
Winly vs ManyChat

ManyChat has no official MCP server. See how Winly compares.

Guide
Open

Frequently asked questions

How do I add a remote MCP server to Gemini CLI?

Run gemini mcp add --transport http with a name and the server URL. Add -s user to use it in every project.

Should I use httpUrl or url in Gemini CLI settings.json?

Use httpUrl for a Streamable HTTP server like Winly. Google's docs say url is for SSE servers.

Does Gemini CLI support OAuth for MCP servers?

Yes. Google's docs say Gemini CLI finds the sign-in details on its own and you sign in with /mcp auth.

Does Gemini CLI ask before it uses a Winly tool?

Yes, by default. You can allow a tool once, always allow it, or cancel. Keep sends on ask-first if you want to check each DM.

Is the Winly MCP server free to use with Gemini CLI?

You can start on Winly's Free plan. It's $0 with 300 credits a month and 2 connected accounts, and you don't need a card. A lookup of 25 results or fewer costs 0 credits, and a bigger list costs 2 or more. Most changes cost 1 credit. A DM or a private reply to a comment costs 2.