Use MisarMail's Model Context Protocol server to send emails, manage campaigns, and query analytics directly from AI assistants like Claude.

MisarMail MCP Server

The MisarMail MCP server exposes the MisarMail API as Model Context Protocol tools. Connect it to any MCP-compatible AI assistant to send transactional emails, manage campaigns, handle contacts, render templates, run A/B tests, and pull analytics — without leaving your chat interface.

Tools at a glance

Category	Tools
Send	`send_email`
Campaigns	`list_campaigns`, `get_campaign`, `create_campaign`, `send_campaign`
Contacts	`list_contacts`, `create_contact`, `import_contacts`
Analytics	`get_analytics`
Templates	`list_templates`, `create_template`, `render_template`
Validation	`validate_email`
Sandbox	`list_sandbox_sends`, `clear_sandbox`
AI	`generate_subject_lines`
A/B Testing	`list_ab_tests`, `create_ab_test`, `select_ab_test_winner`
Inbox	`list_inbox_conversations`, `get_inbox_conversation_messages`, `categorize_inbox_emails`
Automations	`list_automations`, `get_automation`, `toggle_automation`
Domains	`list_domains`, `add_domain`, `verify_domain`
Forms	`list_forms`, `get_form`, `get_form_submissions`
Integrations	`list_integrations`, `get_integration`, `toggle_integration`
Marketplace	`list_marketplace_items`, `get_marketplace_item`

See Tools Reference for full parameter details.

Prerequisites

A MisarMail account at mail.misar.io
An API key from Developers → API Keys with the scopes you need (send, read, contacts, analytics)

Installation

Install the package from npm:

npm install -g @misar/mcp-mail

Or run it directly with npx (no install required):

npx @misar/mcp-mail

Set your API key as an environment variable:

export MISARMAIL_API_KEY=msk_your_key_here

Configuration

Claude Code

Add to your project's .mcp.json or ~/.claude/mcp.json:

{
  "mcpServers": {
    "misar-mail": {
      "command": "npx",
      "args": ["-y", "@misar/mcp-mail"],
      "env": {
        "MISARMAIL_API_KEY": "msk_your_key_here"
      }
    }
  }
}

Claude Desktop

Add to claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "misar-mail": {
      "command": "npx",
      "args": ["-y", "@misar/mcp-mail"],
      "env": {
        "MISARMAIL_API_KEY": "msk_your_key_here"
      }
    }
  }
}

Cursor

Add to .cursor/mcp.json in your project root:

{
  "mcpServers": {
    "misar-mail": {
      "command": "npx",
      "args": ["-y", "@misar/mcp-mail"],
      "env": {
        "MISARMAIL_API_KEY": "msk_your_key_here"
      }
    }
  }
}

Cline (VS Code)

In the Cline extension settings, under MCP Servers, add:

{
  "misar-mail": {
    "command": "npx",
    "args": ["-y", "@misar/mcp-mail"],
    "env": {
      "MISARMAIL_API_KEY": "msk_your_key_here"
    }
  }
}

Environment variables

Variable	Required	Description
`MISARMAIL_API_KEY`	Yes	MisarMail API key (`msk_...`) — get one at mail.misar.io → Developers
`MISAR_API_URL`	No	Override API base URL (default: `https://api.misar.io/mail/v1`)

API key scopes

Scope	Required by
`send`	`send_email`
`send:marketing` or `campaigns`	`list_campaigns`, `get_campaign`, `create_campaign`, `send_campaign`
`contacts` or `read`	`list_contacts`, `create_contact`, `import_contacts`
`analytics`	`get_analytics`
`read`	`list_templates`, `render_template`, `list_sandbox_sends`, `list_ab_tests`, `list_automations`, `get_automation`, `list_domains`, `list_forms`, `get_form`, `get_form_submissions`, `list_integrations`, `get_integration`, `list_marketplace_items`, `get_marketplace_item`
`send` or `read`	`create_template`
`send`	`validate_email`, `generate_subject_lines`, `clear_sandbox`
`send:marketing`	`create_ab_test`, `select_ab_test_winner`, `toggle_automation`, `toggle_integration`
`read` + inbox access	`list_inbox_conversations`, `get_inbox_conversation_messages`, `categorize_inbox_emails`
`domains`	`add_domain`, `verify_domain`

MisarMail MCP Server

On this page