MCP for Instagram DMs
An Instagram DM MCP server on Meta's official API.
dmswift is a hosted MCP server that lets Claude, ChatGPT, Cursor and other MCP clients read your Instagram DMs and answer them through Meta's official API, never with your password or a session cookie. It is for Instagram professional accounts, it replies only inside Meta's 24-hour window, and it starts at $19 a month after a 7-day free trial with no card.
Connection details
https://app.dmswift.com/mcp- Sign-in
- OAuth, or an API key
- Plan
- Included from Starter, $19/month
7 days free with Pro features, no card
How can an AI agent read and answer Instagram DMs?
An AI app such as Claude or ChatGPT cannot open Instagram by itself. It needs an MCP server: a service that turns actions like "list my conversations" or "send this reply" into tools the agent can call. For DMs, the server has to reach your inbox somehow, and there are two ways to do that.
One kind of server logs into Instagram as you, with your password or a session cookie copied from your browser, and drives the account the way the app would. The other kind connects through Meta's official messaging API, after you approve access with Instagram's own login. dmswift is the second kind, and it is hosted, so there is nothing to install. It is not the only hosted official-API option; several Instagram automation products now offer one.
Cookie or password servers versus official-API servers
Many open-source Instagram DM servers you will find in MCP directories work with a session cookie or a password. The difference matters more for DMs than for anything else, because messaging is where Instagram is strictest.
| Cookie or password server | Official-API server | |
|---|---|---|
| How it signs in | Your Instagram password or a browser session cookie, stored by the server | Instagram's own login screen; the server gets a token, never your password |
| Accounts | Usually any account, personal included | Instagram professional accounts (Business or Creator) |
| Who it can message | Whatever the app allows, including people who never wrote to you | Only people who wrote first, inside Meta's windows |
| Standing with Instagram | Automation outside Meta's API; Instagram's terms restrict it | The route Meta provides for business tools |
| When it breaks | When Instagram changes its app or challenges the login | When a token expires or a permission is removed, with a clear error |
Logging in with a session cookie or a password is automation outside Meta's API, and Instagram's Terms of Use restrict accessing accounts or collecting information in unauthorized or automated ways. It also hands your login to whoever runs the server.
The official API is the route Meta built for business tools, but it does not put an account beyond Meta's rules: an account or app that sends unwanted messages can still be restricted. What it removes is the login problem, and it makes the messaging rules explicit, so an agent gets a clear error instead of a silent risk.
What is the 24-hour window, and why must the agent respect it?
Instagram lets a business message a person only after that person acts first, and for most actions only for 24 hours afterwards (Meta's Instagram messaging docs). Every new message from the person opens a fresh 24 hours.
A comment opens a narrower door: one private reply per comment, within 7 days of the comment, and more messages only if the person answers, within 24 hours of their answer (Meta's Private Replies docs).
An agent does not know these rules by itself, and a well-meant "follow up with everyone from last week" would break them. dmswift checks the window on every reply: outside it the send is refused with err.inbox_window_closed, and the agent is told the person has to write again first. The glossary defines the terms.
Which DM tools does dmswift expose?
list_conversationslists the conversations people started with your account, newest first, with the person's name and username, a preview of the last message,unread,window_openandtakeover_active. Filter by status (open, done, snoozed or all), unread only, or search text.get_conversationreads one conversation's messages, oldest first, pluswindow_openand the time the window closes. The agent pages back through older messages when it needs more context.reply_to_conversationsends a private reply, only whilewindow_openis true andtakeover_activeis false. It is refused for anyone who opted out, and for a connection set to ask before anything is published.- Limits. By default 100 private messages a day per connection, which you can change when you connect, and at most 3 replies a minute to one conversation. A spent cap returns
daily_capwith the time it resets. - Retries. Replies take an optional
idempotency_key, so an agent that lost an answer can retry without sending the same message twice.
Can the agent start a DM with someone new?
No. Meta's messaging API only allows messages to people who wrote to you first, so there is no tool for messaging a new person, and none for messaging a list. Broadcasts are not available to agents.
This is the same rule the unified inbox follows for people on your team: you can answer anyone who wrote to you, and nobody else.
What starts a conversation?
- The person writes first. Any direct message to your account opens a conversation and a 24-hour window.
- A story reply or a mention. A reply to one of your stories, or a mention of your account in someone's story, lands in the inbox like a message.
- A comment campaign's private reply. When someone comments your keyword, a comment to DM campaign sends them one private reply. That reply does not open a window by itself: the agent can follow up only after the person answers.
- A tap on a growth link or QR code that opens a conversation with a code you chose.
Set it up in Claude, ChatGPT or Cursor
- Sign up for dmswift with Google and connect your Instagram professional account with Instagram's own login.
- Claude on the web or desktop: Customize, then Connectors, then Add custom connector. Name it dmswift, paste
https://app.dmswift.com/mcp, choose Add, then Connect and sign in. It then works in the mobile apps too. Claude guide. - Claude Code: run
claude mcp add --transport http --scope user dmswift https://app.dmswift.com/mcp, then/mcpand Authenticate. - ChatGPT in a browser: open chatgpt.com/plugins, choose +, then Add custom MCP server. Name it, paste the URL, choose OAuth, tick I understand and want to continue, then Create as a plugin. In a chat, type @ and pick it. ChatGPT guide.
- Cursor: use the Add to Cursor button on the dashboard's AI agents page, or add
https://app.dmswift.com/mcpto~/.cursor/mcp.json, then sign in when Cursor asks. Cursor guide. - On dmswift's consent screen, pick the channel. Read only lets the agent read and summarize your DMs. The Instagram MCP server page lists every other permission and security explains the controls. To let it reply, choose Full access, or tick the inbox reply permission yourself.
A worked example: triage yesterday's DMs
You ask for a summary and drafts. The agent checks each thread's window and takeover state, shows you what it would send, and sends only what you approve.
Go through my Instagram DMs from yesterday. Tell me who wrote and what they want, draft a reply for each, and don't send anything until I say so.
Six conversations had messages yesterday. Four are inside the 24-hour window: Dana asks if Thursday's workshop still has seats, Omer wants the price list, Lior asks about delivery to Haifa, and Noa says thanks for the guide. I drafted a reply for each, below. One conversation's window closed three hours ago, so it can't be answered until they write again. Someone on your team took one over, so I left it alone. Send all four drafts?
Send Dana, Omer and Noa. Skip Lior, I'll call him.
Sent three replies. Lior's conversation is still open, with about nine hours left in the window.
Behind it: list_conversations to find the threads and their last messages, get_conversation on each to read the messages and check window_open and takeover_active, and reply_to_conversation only for the three you approved.
The drafts were shown in the chat, which is not the same as dmswift's approval mode. Every sent reply appears in the inbox transcript next to your own.
FAQ
Frequently asked questions
Does it work with a personal Instagram account?
No. Meta's API only reaches professional accounts (Business or Creator). Switching is free and takes a minute in the Instagram app: how to connect Instagram.
Do I need my own Meta developer app?
No. You connect Instagram with Instagram's own login inside dmswift, and dmswift's Meta app does the rest. Self-hosted official-API servers usually need your own app, tokens and app review.
Can a person on my team take a conversation over?
Yes. Take a thread over in the inbox and every automation goes quiet for that person, the agent included: reply_to_conversation is refused with human_takeover until the thread is handed back.
How is this different from dmswift's built-in AI replies?
Built-in AI replies run on dmswift around the clock, from the Pro plan: they answer from your knowledge base, score their own confidence and hand the conversation to a person below your threshold. An agent replying over MCP is your own Claude or ChatGPT acting when you ask it to, in a chat. DM automation explains the built-in side.
Which plan do I need?
MCP is included from Starter at $19/month, and in the 7-day trial. Reading conversations is free; each reply is a write call and counts as an agent action, 300 a month on Starter. See pricing.
Does it answer Facebook Messenger too?
Not yet. Facebook Pages are coming soon for new accounts, once Meta approves Page messaging for dmswift. Today the inbox tools cover Instagram DMs.
Keep reading
Keep reading
Instagram MCP server
A hosted MCP server that lets Claude, ChatGPT, Cursor or Grok publish, run comment-to-DM campaigns and answer DMs on your Instagram.
FeatureUnified inbox
Instagram DMs in one thread per person, with human takeover and the 24-hour window on every thread. Messenger coming soon.
FeatureDM keyword automations
When someone messages you a keyword, they get the answer at once, with buttons and tracked links.
Agent setupClaude
Add dmswift as a custom connector in Claude or Claude Code and run your Instagram from a chat.
Try dmswift free for a week.
No card. If it does not pay for itself in a week, let it pause.
- 15,000 DMs a month on Pro
- Unlimited contacts on every plan
- Messages only go to people who wrote first