Introduction
Work your Instagram DMs from Codex. You don't need a Meta developer app or any code. You add one Winly server to Codex, sign in to Winly and ask in plain words.
For the name and inputs of every tool, see the Winly docs.
Also connect Instagram DMs to
Why use Winly?
- One server URL connects your Instagram and Facebook DMs to Codex.
- Meta's official API. No shared passwords and no browser cookies.
- A sales pipeline underneath. Codex gets stages, tags, owners and reports along with your messages.
- You choose who presses send. Codex can draft replies for you to approve, or reply for you. You set this in Codex.
Connecting Instagram DMs to OpenAI Codex (CLI, IDE extension, desktop app) using Winly
What you need
- Codex CLI, the Codex IDE extension or the ChatGPT desktop app.
- A free Winly account with an Instagram professional account or a Facebook Page connected.
- A Winly login to approve the connection.
- A browser for sign-in. Without one on the same computer, use codex mcp login winly --no-browser.
Copy this command and run it in your terminal.
codex mcp add winly --url https://app.sbccrm.com/bld/api/mcpThe server URL on its own:
https://app.sbccrm.com/bld/api/mcpThen 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 Codex to your own Instagram and Facebook inbox. Codex 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
- 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 linkhttps://app.sbccrm.com/mcp/signup - 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.
- Add the Winly server
Run this in your terminal. Codex keeps MCP servers in ~/.codex/config.toml. The CLI, the IDE extension and the desktop app share that setup.
Terminalcodex mcp add winly --url https://app.sbccrm.com/bld/api/mcp - Start the sign-in
Run the login command to start the Winly sign-in.
Terminalcodex mcp login winly - Sign in to Winly and approve
Your browser opens the Winly sign-in page. Sign in to Winly and approve.
- Check the connection
Start codex and type /mcp. Winly should be in the list of active servers.
Codex/mcp - Ask a first question
In Codex, ask: Which leads haven't replied this week? Put them in a table.
Setup from Codex's docs, read Nov 19, 2026: Model Context Protocol (ChatGPT Learn, Codex).
Things to ask
- "Which leads haven't replied this week? Put them in a table."
- "List contacts added this week with stage and owner and save them as a CSV in this repo."
- "What's our response rate by teammate this month?"
- "Draft a reply to my newest Instagram DM so I can approve it."
If it won't connect
- Winly tools fail with a sign-in error? Codex can connect to a server without signing in. Run codex mcp login winly to sign in to Winly.
- No browser on this computer? Run codex mcp login winly --no-browser. Open the link it prints in any browser and sign in. Then paste the full redirect URL back into the terminal.
- Using the ChatGPT desktop app? Open Settings, select MCP servers, then Add server. Choose Streamable HTTP, paste the Winly URL, save and select Restart. Then select Authenticate and sign in to Winly.
- Using the Codex IDE extension? Open the gear menu, select MCP servers, then Add server. Choose Streamable HTTP, paste the Winly URL, save and select Restart extension.
- Winly missing from /mcp? Run codex mcp list. If Winly isn't there, open ~/.codex/config.toml and check the [mcp_servers.winly] block has the Winly url.
- Message didn't send to an old lead? Winly sends text only up to 7 days after the person's last message or reaction, and images, video or audio only up to 24 hours after their last message. It blocks anything later. Winly also replies only to people who messaged, commented or reacted first.