Allows AI clients to read and reply to Instagram, WhatsApp, and Facebook Messenger conversations using official Meta Business APIs.
Also known as setsmart-git/instagram-mcp, instagram-mcp, setsmart-mcp
- Stars
- 0
- Tools
- 30
- Downloads, 30 days
- —
- Latest version
- 0.1.2
- Last commit
- Aug 26, 2026
- License
- MIT
What is SetSmart MCP?
SetSmart allows AI clients to read and reply to Instagram, WhatsApp, and Facebook Messenger conversations using official Meta Business APIs. It exposes 30 tools, such as message_send_text, message_send_image, message_send_video.
Summary generated from the project's README
About SetSmart MCP server
SetSmart provides a bridge for AI clients like Claude, Cursor, and Claude Code to interact with Meta Business channels. It enables users to read and reply to messages across Instagram, WhatsApp, and Facebook Messenger. Instead of using browser automation or unofficial methods that risk account suspension, this server connects through the official Instagram Messaging API, WhatsApp Cloud API, and Messenger Platform via a Meta-approved business application.
To use this server, you need a SetSmart workspace with at least one connected channel and a workspace API key. The server functions as a stdio to Streamable HTTP pipe, meaning it forwards requests from your local client to the hosted SetSmart MCP endpoint. It includes 30 tools categorized into messaging, conversation management, contact handling, AI control, Instagram-specific actions, and scheduling or analytics.
This setup is designed for developers who prefer using a static API key over interactive OAuth. While it facilitates messaging and data retrieval, it does not allow for billing changes, workspace settings modifications, or channel connections through the bridge.
What you can do with it
- 1Automate customer lead follow-upsAsk your AI assistant to identify a specific lead from Instagram and send them a predefined booking template.
- 2Manage multi-channel message historySearch through various conversations by name, phone number, or specific content to find past interactions.
- 3Control AI assistant autonomyPause the AI assistant on a specific conversation to allow for a human handover.
- 4Organize contacts with metadataFind specific contacts using their email or Instagram username and apply organizational tags.
Written from the project's README. Every use case is checked against a quote from it.
How to install SetSmart MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall SetSmart MCP in Claude Code
$ claude mcp add --env 'SETSMART_API_KEY=<YOUR_SETSMART_API_KEY>' instagram-mcp -- npx -y setsmart-mcpInstall SetSmart MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"instagram-mcp": {
"command": "npx",
"args": [
"-y",
"setsmart-mcp"
],
"env": {
"SETSMART_API_KEY": "<YOUR_SETSMART_API_KEY>"
}
}
}
}Install SetSmart MCP in VS Code
.vscode/mcp.json
{
"servers": {
"instagram-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"setsmart-mcp"
],
"env": {
"SETSMART_API_KEY": "<YOUR_SETSMART_API_KEY>"
}
}
}
}Install SetSmart MCP in VS Code CLI
$ code --add-mcp '{"name":"instagram-mcp","type":"stdio","command":"npx","args":["-y","setsmart-mcp"],"env":{"SETSMART_API_KEY":"<YOUR_SETSMART_API_KEY>"}}'Install SetSmart MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"instagram-mcp": {
"command": "npx",
"args": [
"-y",
"setsmart-mcp"
],
"env": {
"SETSMART_API_KEY": "<YOUR_SETSMART_API_KEY>"
}
}
}
}Install SetSmart MCP in Codex
$ codex mcp add instagram-mcp --env 'SETSMART_API_KEY=<YOUR_SETSMART_API_KEY>' -- npx -y setsmart-mcpInstall SetSmart MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.instagram-mcp] command = "npx" args = ["-y", "setsmart-mcp"] [mcp_servers.instagram-mcp.env] SETSMART_API_KEY = "<YOUR_SETSMART_API_KEY>"
Install SetSmart MCP in Gemini CLI
$ gemini mcp add -s user -e 'SETSMART_API_KEY=<YOUR_SETSMART_API_KEY>' instagram-mcp npx -- -y setsmart-mcpInstall SetSmart MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"instagram-mcp": {
"command": "npx",
"args": [
"-y",
"setsmart-mcp"
],
"env": {
"SETSMART_API_KEY": "<YOUR_SETSMART_API_KEY>"
}
}
}
}Needs a key before it starts
Started on 16 Nov 2026 with no keys, it stopped and asked for one, so a client sees no tools until you set the variables above.
SetSmart MCP tools 30
Detected from the READMEmessage_send_textmessage_send_imagemessage_send_videomessage_send_audiomessage_send_templatemessage_send_reactionconversation_listconversation_searchconversation_getconversation_get_messagesconversation_add_tagconversation_remove_tag
Show all 30 toolsShow fewer tools
conversation_set_notescontact_findcontact_getcontact_importcontact_add_tagscontact_remove_tagsai_get_all_statusai_pause_conversationai_resume_conversationai_pause_channelai_resume_channelinstagram_post_listinstagram_post_get_triggerscomment_reply_get_auto_replyscheduled_listscheduled_canceltemplate_listanalytics_stats
Configuration
SETSMART_API_KEYRequiredSecretYour SetSmart workspace API key, from Settings then Integrations
Automated checks
Ran Nov 14, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachablesetsmart-git/instagram-mcp is public and reachablegithub.com/setsmart-git/instagram-mcp ↗Pass
- Package names this repository as its sourcesetsmart-mcp names setsmart-git/instagram-mcp as sourcenpmjs.com/package/setsmart-mcp ↗Pass
- Build provenance (Sigstore attestation)No build attestation published for this releaseNot checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-08-26github.com/setsmart-git/instagram-mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from setsmart-mcpPass
- No critical advisory in the package or its dependencies99 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model30 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNo tool named like delete, drop or execPass
- Remote endpoint answers the MCP handshakeHTTPS endpoint answered 401 (sign-in required)Pass
README
View on GitHubInstagram MCP Server (also WhatsApp and Messenger)
An MCP server that lets Claude, Cursor, Claude Code and any other MCP client read and reply to Instagram DMs, WhatsApp messages and Facebook Messenger conversations, through the official Meta Business APIs.
Ask your assistant to "find the lead who asked about pricing on Instagram and send them the booking template", and it happens on the real account.
Why this one is different
Most Instagram and WhatsApp MCP servers drive a personal account: a browser automation session, an unofficial bridge, or a reverse engineered mobile API. They break when Meta changes something, and they put the account at risk of being disabled.
This one talks to the official Instagram Messaging API, WhatsApp Cloud API and Messenger Platform, through SetSmart's Meta-approved Business app. Messaging Instagram, WhatsApp or Messenger programmatically is not possible without an approved app, which is why this bridge requires a SetSmart workspace rather than your Instagram password.
That is the tradeoff, stated plainly: it is not self-hostable against your own account, and it needs a SetSmart API key.
Requirements
- Node.js 18 or newer
- A SetSmart workspace with at least one channel connected (Instagram, WhatsApp or Messenger)
- Your workspace API key, from Settings then Integrations
Quick start
Claude Desktop / Claude Code
Add this to your MCP config (claude_desktop_config.json, or .mcp.json for Claude Code):
{
"mcpServers": {
"setsmart": {
"command": "npx",
"args": ["-y", "setsmart-mcp"],
"env": {
"SETSMART_API_KEY": "your-workspace-api-key"
}
}
}
}
Cursor
Same block, in ~/.cursor/mcp.json.
Remote MCP, without this bridge
The SetSmart MCP server is also reachable directly over Streamable HTTP with OAuth, so clients that support remote MCP can skip this package entirely:
https://setsmart.io/api/mcp
Use this bridge when your client only speaks stdio, or when you would rather authenticate with a static API key than an interactive OAuth consent.
Tools
30 tools, grouped by what they touch.
Messaging
| Tool | What it does |
|---|---|
message_send_text |
Send a text message on Instagram, WhatsApp or Messenger |
message_send_image |
Send an image |
message_send_video |
Send a video |
message_send_audio |
Send a voice message |
message_send_template |
Send an approved WhatsApp template |
message_send_reaction |
React to a message |
Conversations
| Tool | What it does |
|---|---|
conversation_list |
List conversations in the workspace |
conversation_search |
Search conversations by name, number or content |
conversation_get |
Read one conversation and its status |
conversation_get_messages |
Read the message history |
conversation_add_tag |
Tag a conversation |
conversation_remove_tag |
Remove a tag |
conversation_set_notes |
Write internal notes |
Contacts
| Tool | What it does |
|---|---|
contact_find |
Find a contact by phone, email, Instagram username or tag |
contact_get |
Read one contact |
contact_import |
Create a contact |
contact_add_tags |
Add tags |
contact_remove_tags |
Remove tags |
AI control
| Tool | What it does |
|---|---|
ai_get_all_status |
See where the AI assistant is active |
ai_pause_conversation |
Stop the assistant on one conversation, for a human handover |
ai_resume_conversation |
Hand it back to the assistant |
ai_pause_channel |
Pause a whole channel |
ai_resume_channel |
Resume a channel |
| Tool | What it does |
|---|---|
instagram_post_list |
List the account's posts |
instagram_post_get_triggers |
Read the comment triggers on a post |
comment_reply_get_auto_reply |
Read the automatic comment reply setup |
Scheduling, templates and stats
| Tool | What it does |
|---|---|
scheduled_list |
List messages scheduled but not sent |
scheduled_cancel |
Cancel a scheduled message |
template_list |
List message templates |
analytics_stats |
Read conversation and reply stats |
What it deliberately cannot do
An API key is a long lived static secret, so it gets a restricted surface. These are reachable through interactive OAuth on the remote server, never through this bridge:
- billing and subscription changes
- workspace settings
- connecting or disconnecting a channel
- creating or rewriting AI assistants
- bulk deletion, blacklists, blocked countries
Rotating the key in your SetSmart settings revokes access immediately, on the next request.
Configuration
| Variable | Default | Purpose |
|---|---|---|
SETSMART_API_KEY |
required | Your workspace API key |
SETSMART_MCP_URL |
https://setsmart.io/api/mcp |
Override the upstream endpoint |
How it works
This package contains no messaging logic. It is a stdio to Streamable HTTP pipe: your client speaks MCP over stdin and stdout, the bridge forwards each request to the hosted SetSmart MCP server with your key in the Authorization header, and streams the answer back. Around 150 lines, in src/index.js, so you can read all of it before trusting it with an account.
Links
License
MIT
SetSmart MCP questions
How do I add SetSmart MCP to Claude Code?
Run claude mcp add --env 'SETSMART_API_KEY=<YOUR_SETSMART_API_KEY>' instagram-mcp -- npx -y setsmart-mcp in your terminal. Add --scope user to make it available in every project.
How do I add SetSmart MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does SetSmart MCP provide?
It exposes 30 tools, including message_send_text, message_send_image, message_send_video, message_send_audio, message_send_template.
Does this server use official APIs?
Yes, it uses the official Instagram Messaging API, WhatsApp Cloud API, and Messenger Platform through a Meta-approved Business app.
Can I self-host this server with my own account?
No, it requires a SetSmart workspace and an API key because messaging these platforms programmatically requires an approved app.
How do I revoke access?
You can revoke access immediately by rotating the API key in your SetSmart settings.