SendSeven Messaging MCP server

SendSeven MCP Server

The official Model Context Protocol (MCP) server for SendSeven - the unified messaging API platform for WhatsApp, Instagram DMs, Telegram, SMS, Messenger, Live Chat, and Email.

Connect your SendSeven account to Claude, ChatGPT, Gemini, Cursor, or any MCP-compatible AI assistant to manage your unified inbox, send omnichannel messages (WhatsApp, Instagram private replies, Telegram, SMS, Messenger, email), run marketing campaigns, staff a team chat bot, and search your knowledge base using natural language — all through your existing customer support and messaging API platform.

Quick Start

Option 1: Remote Server (Recommended)

No installation needed. Add to your AI client:

Claude Desktop (claudedesktopconfig.json):

{
  "mcpServers": {
    "sendseven": {
      "url": "https://mcp.sendseven.com/mcp",
      "auth": {
        "type": "oauth2",
        "authorizationUrl": "https://mcp.sendseven.com/authorize",
        "scopes": ["conversations:read", "messages:create", "contacts:read"]
      }
    }
  }
}

Claude Code (.claude/settings.json):

{
  "mcpServers": {
    "sendseven": {
      "url": "https://mcp.sendseven.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}

ChatGPT (Settings > Connectors > Add custom connector):

MCP Server URL: https://mcp.sendseven.com/mcp
Authentication: OAuth

ChatGPT walks you through the OAuth consent + capability picker automatically — no config file needed.

Option 2: API Token (Developer Setup)

For developers and CI/CD pipelines, use a static API token:

1. Generate an API token in SendSeven: Settings > API Tokens
2. Configure your MCP client with the token as a Bearer header

Option 3: Self-Hosted

git clone https://github.com/SendSeven-GmbH/sendseven-mcp-server.git
cd sendseven-mcp-server
npm install
npm run dev  # Runs on localhost:8787

What Can It Do?

Support Operations

• "Show me open conversations" - List and filter conversations
• "What's the conversation with John about?" - View conversation details
• "Close ticket #123 with notes: refund issued" - Close conversations
• "Assign this to Sarah" - Route to team members

Messaging

• "Send a WhatsApp to +49 170 1234567: Your order is ready" - Multi-channel messaging
• "Email john@example.com about the meeting" - Auto-detect best channel
• "Find all VIP customers" - Contact search

Marketing

• "Create a push notification campaign about our flash sale" - Campaign creation
• "Send an email newsletter to our enterprise list" - Email campaigns
• "How much would a WhatsApp campaign cost?" - Cost estimation

Knowledge Base

• "What does our FAQ say about refunds?" - AI-powered KB search
• "How do I set up WhatsApp integration?" - Self-service answers

Available Tools

Tools are registered based on the capabilities selected during the OAuth connection. The table below groups tools by function for readability; the OAuth consent screen groups the same 42 tools into 8 coarser capability groups (Conversations, Messaging, Email, Contacts, Campaigns, Knowledge Base, Webhooks, Team Chat Bots) — granting a group grants every tool listed under it below. Full parameter reference: docs/TOOLS.md.

Shortened. The full README is on GitHub.