misarmail-mcp-server

MisarMail MCP Server

Full email marketing platform accessible via Model Context Protocol

What is MisarMail MCP?

MisarMail MCP exposes the full MisarMail email marketing platform as a set of Model Context Protocol tools — making it directly callable from any MCP-compatible AI client.

Capability	Details
Tools	32 tools across email, campaigns, contacts, templates, automations, analytics, and more
Skills	11 pre-built skills for common workflows
Prompts	5 guided prompts
Transport	HTTP (Streamable HTTP)
Auth	OAuth 2.0 (PKCE) + API Key
Server URL	https://mail.misar.io/api/mcp

With MisarMail MCP, your AI assistant can send emails, manage contacts, create and launch campaigns, run A/B tests, check deliverability health, generate AI subject lines, send WhatsApp messages, and produce revenue analytics — all through natural language.

Quick Start

Pick your AI client and add MisarMail in under 60 seconds.

Claude Desktop / Claude Code

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "misarmail": {
      "url": "https://mail.misar.io/api/mcp",
      "transport": "http"
    }
  }
}

Cursor

Add to your Cursor MCP settings (.cursor/mcp.json or Cursor → Settings → MCP):

{
  "mcpServers": {
    "misarmail": {
      "url": "https://mail.misar.io/api/mcp",
      "transport": "http"
    }
  }
}

VS Code (GitHub Copilot)

Add to .vscode/mcp.json in your workspace, or to your user settings:

{
  "servers": {
    "misarmail": {
      "url": "https://mail.misar.io/api/mcp",
      "type": "http"
    }
  }
}

Cline

Add to your Cline MCP configuration:

{
  "mcpServers": {
    "misarmail": {
      "url": "https://mail.misar.io/api/mcp",
      "transport": "http"
    }
  }
}

Windsurf

Add to your Windsurf MCP settings:

{
  "mcpServers": {
    "misarmail": {
      "url": "https://mail.misar.io/api/mcp",
      "transport": "http"
    }
  }
}

Docker (self-hosted proxy)

Run a local MCP proxy container that forwards to mail.misar.io/api/mcp:

docker run -p 3000:3000 ghcr.io/mrgulshanyadav/misarmail-mcp

Then point your client to http://localhost:3000.

npm

Run the MCP server directly without Docker:

npx misarmail-mcp-server

Authentication

MisarMail MCP supports two authentication methods:

OAuth 2.0 (Recommended)

OAuth 2.0 with PKCE is handled automatically by clients like Claude Desktop — you will be redirected to mail.misar.io to authorize and the token is managed for you. No manual setup required.

API Key

For programmatic access or clients that do not support OAuth:

• Generate an API key at mail.misar.io/developers
• Pass it as a Bearer token in the Authorization header:

Authorization: Bearer msk_your_api_key_here

API keys start with msk_.

Tools Reference

32 tools organized by category:

Category	Tool	Description
Email	email.list	List emails from inbox, sent, archive, or any folder
Email	email.read	Read a specific email by ID
Email	email.send	Send a transactional or marketing email
Email	email.reply	Reply to an existing email thread
Email	email.archive	Archive an email
Campaigns	campaign.list	List email marketing campaigns
Campaigns	campaign.get	Get details of a specific campaign
Campaigns	campaign.create	Create a new email marketing campaign
Campaigns	campaign.send	Send or schedule a campaign
Contacts	contact.list	List contacts from your contact lists
Contacts	contact.add	Add a new contact
Contacts	contact.update	Update an existing contact
Contacts	contact.score	Get contact engagement score, tier, and churn risk
Templates	template.create	Create a reusable email template
Analytics	analytics.get	Get campaign and deliverability analytics
Warmup	warmup.get	Get IP warmup status and progress
Deliverability	account.score	Get deliverability score (0–100) and grade (A–F)
Deliverability	dmarc.check	Check domain DMARC/SPF/DKIM health
Deliverability	deliverability.audit	Run full deliverability audit with recommendations
API Keys	key.list	List API keys for the account
Automation	automation.list	List automation workflows
Automation	automation.create	Create automation workflow
A/B Testing	abtest.create	Create A/B test variant for a campaign
A/B Testing	abtest.winner	Select A/B test winner
AI	ai.subject_lines	Generate AI subject line suggestions with predicted scores
Landing Pages	landing_page.create	Create a landing page with block-based content
Inbound	inbound.configure	Configure inbound email domain
Multi-Channel	channel.whatsapp_send	Send WhatsApp message via Business API
Multi-Channel	channel.push_send	Send web push notification
Revenue	revenue.attribution	Get ecommerce revenue attribution by campaign
Revenue	monetization.stats	Get newsletter monetization stats (MRR, tips, sponsors)
Reports	report.generate	Generate advanced analytics reports (cohorts, heatmaps, funnels)

Skills

11 pre-built skills that package tools + instructions into guided workflows:

Skill	Description
Send Transactional Email	Send password resets, order confirmations, and notifications with confirmation before sending
Manage Email Inbox	Read, search, reply to, and organize emails across all folders
Create & Send Email Campaign	Full campaign lifecycle from draft creation to scheduling and analytics
Manage Contacts	Add, update, search, tag, and manage subscription status for contacts
Check Email Deliverability & Warmup	Monitor deliverability score, IP warmup progress, bounce and complaint rates
Create Email Template	Build reusable HTML templates with merge tag personalization
Build Email Automation	Create automated workflows — welcome series, cart recovery, re-engagement
Optimize Deliverability	Run full audits, check DMARC/SPF/DKIM, and get AI recommendations
AI Email Content Assistant	Generate subject lines with predicted scores, create A/B tests, optimize send times
Multi-Channel Messaging	Send across email, WhatsApp, and web push from one interface
Revenue & Analytics	Track ecommerce revenue attribution, monetization stats, and advanced reports

Example Prompts

Once connected, you can say things like:

• "Send a password reset email to [e-mail] from [e-mail]"
• "Show me the last 10 unread emails in my inbox"
• "Create a welcome campaign for new signups and schedule it for Monday 9am"
• "What's my deliverability score and how can I improve it?"
• "Generate 5 subject line ideas for our Black Friday sale with urgency tone"
• "Add [e-mail] to my contacts with tags newsletter and vip"
• "Check DMARC and SPF for example.com"
• "Send a WhatsApp message to [phone]"
• "Which campaign generated the most revenue last month?"
• "Run a full deliverability audit and show recommendations"

Distribution

MisarMail MCP is available on all major registries:

Platform	Link
npm	npmjs.com/package/misarmail-mcp-server
Smithery	smithery.ai/server/misarmail/misarmail
mcp.so	mcp.so/server/misarmail
mcpservers.org	mcpservers.org/server/misarmail
mcpserver.dev	mcpserver.dev/server/misarmail
awesome-mcp-servers	Listed under Email & Marketing category
Glama	glama.ai/mcp/servers/misarmail
Cursor Directory	Listed under Productivity & Email
Docker Hub	ghcr.io/mrgulshanyadav/misarmail-mcp

Links

• Website: mail.misar.io
• Documentation: mail.misar.io/docs
• npm: npmjs.com/package/misarmail-mcp-server
• Smithery: smithery.ai/server/misarmail/misarmail
• Author: Misar AI

License

MIT — see LICENSE