emperor-mail

{
  "name": "io.github.yarenty/emperor-mail",
  "title": "emperor-mail",
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "version": "0.1.3",
  "packages": [
    {
      "version": "0.1.3",
      "transport": {
        "type": "stdio"
      },
      "identifier": "emperor-mail",
      "registryType": "cargo",
      "packageArguments": [
        {
          "type": "positional",
          "value": "serve",
          "valueHint": "serve",
          "isRequired": true,
          "description": "Run the MCP server"
        },
        {
          "type": "positional",
          "value": "--stdio",
          "valueHint": "--stdio",
          "isRequired": true,
          "description": "Speak MCP over stdin/stdout with one mailbox from the environment"
        },
        {
          "type": "positional",
          "value": "--writable",
          "valueHint": "--writable",
          "description": "Offer the draft tool (same as MAIL_WRITABLE=true); without it the server is read-only"
        },
        {
          "type": "positional",
          "value": "--allow-send",
          "valueHint": "--allow-send",
          "description": "Offer the send tool, and draft with it (same as MAIL_ALLOW_SEND=true); without it send is not offered"
        },
        {
          "name": "--send-allow",
          "type": "named",
          "isRepeated": true,
          "description": "Recipients send may write to: an address ([email protected]) or a domain (@example.org); repeatable or comma-separated (same as MAIL_SEND_ALLOW)",
          "placeholder": "@example.org"
        },
        {
          "name": "--from-allow",
          "type": "named",
          "isRepeated": true,
          "description": "From addresses send and draft may use: an address or a domain (@example.org); repeatable or comma-separated (same as MAIL_FROM_ALLOW). Unset: any",
          "placeholder": "@example.org"
        }
      ],
      "environmentVariables": [
        {
          "name": "MAIL_USER",
          "isRequired": true,
          "description": "Login name for IMAP and SMTP",
          "placeholder": "[email protected]"
        },
        {
          "name": "MAIL_PASSWORD",
          "isSecret": true,
          "description": "Password or app password (set this or MAIL_OAUTH_TOKEN)"
        },
        {
          "name": "MAIL_OAUTH_TOKEN",
          "isSecret": true,
          "description": "OAuth 2.0 access token for XOAUTH2, instead of a password (Gmail, Microsoft 365)"
        },
        {
          "name": "MAIL_FROM",
          "description": "From address when the login name is not an address (default: the login name)"
        },
        {
          "name": "IMAP_HOST",
          "isRequired": true,
          "description": "IMAP server host name",
          "placeholder": "imap.example.com"
        },
        {
          "name": "IMAP_PORT",
          "format": "number",
          "description": "IMAP port (default 993, or 143 with starttls)"
        },
        {
          "name": "IMAP_SECURITY",
          "choices": [
            "tls",
            "starttls",
            "plain"
          ],
          "description": "IMAP connection security; plain only for a loopback host (default tls, starttls on port 143)"
        },
        {
          "name": "SMTP_HOST",
          "description": "SMTP server host name, needed only for send",
          "placeholder": "smtp.example.com"
        },
        {
          "name": "SMTP_PORT",
          "format": "number",
          "description": "SMTP port (default 465, or 587 with starttls)"
        },
        {
          "name": "SMTP_SECURITY",
          "choices": [
            "tls",
            "starttls",
            "plain"
          ],
          "description": "SMTP connection security; plain only for a loopback host (default tls, starttls on ports 587 and 25)"
        },
        {
          "name": "MAIL_WRITABLE",
          "format": "boolean",
          "default": "false",
          "description": "true offers the draft tool; unset, empty, false, 0, no or off keep the server read-only"
        },
        {
          "name": "MAIL_ALLOW_SEND",
          "format": "boolean",
          "default": "false",
          "description": "true offers the send tool and draft; unset, empty, false, 0, no or off keep send out of the tool list"
        },
        {
          "name": "MAIL_SEND_ALLOW",
          "description": "Comma-separated recipients send may write to: addresses ([email protected]) or domains (@example.org). With sending on and none set, every recipient is refused",
          "placeholder": "@example.org"
        },
        {
          "name": "MAIL_FROM_ALLOW",
          "description": "Comma-separated From addresses send and draft may use: addresses or domains (@example.org). Unset: any",
          "placeholder": "@example.org"
        }
      ]
    }
  ],
  "repository": {
    "url": "https://github.com/yarenty/emperor-mail",
    "source": "github"
  },
  "websiteUrl": "https://github.com/yarenty/emperor-mail",
  "description": "Email over IMAP and SMTP: search and read messages and attachments; draft and send when switched on"
}