Skip to content
dmswiftdmswift

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.

Last updated 2026-11-19

Connection details

Server URLhttps://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.

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_conversations lists the conversations people started with your account, newest first, with the person's name and username, a preview of the last message, unread, window_open and takeover_active. Filter by status (open, done, snoozed or all), unread only, or search text.
  • get_conversation reads one conversation's messages, oldest first, plus window_open and the time the window closes. The agent pages back through older messages when it needs more context.
  • reply_to_conversation sends a private reply, only while window_open is true and takeover_active is 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_cap with 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

  1. Sign up for dmswift with Google and connect your Instagram professional account with Instagram's own login.
  2. 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.
  3. Claude Code: run claude mcp add --transport http --scope user dmswift https://app.dmswift.com/mcp, then /mcp and Authenticate.
  4. 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.
  5. Cursor: use the Add to Cursor button on the dashboard's AI agents page, or add https://app.dmswift.com/mcp to ~/.cursor/mcp.json, then sign in when Cursor asks. Cursor guide.
  6. 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.

Sample conversation
You

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.

Claude

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?

You

Send Dana, Omer and Noa. Skip Lior, I'll call him.

Claude

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.

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