Misar-AI/misarmail-mcp

> Send email, run campaigns, manage contacts and automations, A/B test, and audit deliverability — from any AI assistant.
55 tools · 8 prompts · 4 resources · 8 agent skills
Works with Claude (Desktop, Code, and web), Cursor, VS Code, Windsurf, Cline,
Zed, Gemini CLI, ChatGPT, and any other MCP-compatible client — over stdio or
Streamable HTTP.
## Install
### Smithery (recommended)
bash
npx -y @smithery/cli install misar/misarmail-mcp --client claude
### Claude Code
bash
claude mcp add misarmail -- npx -y @misarmail/mcp@latest
### Manual (any client)
json
"mcpServers": {
"misarmail": {
"command": "npx",
"args": ["-y", "@misarmail/mcp@latest"],
"env": { "MISARMAILAPIKEY": "mskyourkeyhere" }
Ready-made configs for every client live in connectors/.
### Remote (no install)
json
"mcpServers": {
"misarmail": {
"type": "streamable-http",
"url": "https://api.misar.io/mail/mcp",
"headers": { "Authorization": "Bearer mskyourkeyhere" }
## Authentication
Two options — no copy-paste needed for the first:
1. Browser login. Start the server with no key and run the login tool.
It opens the MisarMail consent screen, you review the requested
permissions, and the key is delivered straight back and saved to
~/.misarmail/config.json.
2. API key. Create one at https://mail.misar.io/developers and set MISARMAILAPIKEY.
Self-hosted instances: set MISARMAILBASEURL.
## Tools
| Tool | Description |
| sendemail | Send a transactional email from a verified MisarMail account. |
| listemails | List emails from a mailbox folder with optional full-text search across subject and body. |
| getemail | Read the full content of a single email by ID, including headers, body, and attachments metadata. |
| replytoemail | Reply to an existing email thread. |
| archiveemail | Move an email to the archive folder. |
| validateemail | Validate an email address before sending: syntax, MX records, disposable-domain and role-account detection. |
| listcampaigns | List email marketing campaigns with their status, audience size, and headline metrics. |
| getcampaign | Get full details for one campaign: content, audience segment, schedule, and delivery statistics (sent, opened, clicked, bounced, complained).. |
| createcampaign | Create a new email marketing campaign as a draft. |
| sendcampaign | Send a campaign now, or schedule it for a future time by passing scheduledat. |
| listcontacts | List contacts with their subscription status and engagement metrics. |
| createcontact | Add a single contact. |
| updatecontact | Update an existing contact by email address, including changing subscription status. |
| importcontacts | Bulk-import up to 5,000 contacts in one call. |
| getcontactscore | Get engagement score, engagement tier, and churn risk for one contact — or the lowest-engagement contacts across the list when contactid is omitted. |
| listtemplates | List saved email templates with their variable placeholders, so you can pick one for a campaign or transactional send.. |
| createtemplate | Create a reusable email template. |
| rendertemplate | Render a template with sample variables and return the resulting HTML and subject. |
| listautomations | List automation workflows (welcome series, re-engagement, drip sequences) with their trigger type and active state.. |