Assistant Mail

assistantmail-mcp

Servidor MCP para AssistantMail — ofereça aos agentes de IA uma caixa de correio gerenciada para enviar e receber e-mails.

Desenvolvido para operadores pessoais e de pequenas equipes do OpenClaw / Hermes que desejam e-mail para agentes com lista de permissões, consentimento, retenção e limites de gastos que você controla. Listado no ClawHub para instalação fácil — não é um endosso oficial do OpenClaw.

Obtenha Grátis · Documentação · Site · Privacidade · Termos · Contribuição

OpenClaw / ClawHub

openclaw skills install @assistantmail/assistant-mail

Em seguida, configure seu cliente MCP para executar este servidor e defina ASSISTANT_MAIL_API_KEY (exemplos do Claude Desktop e Cursor abaixo). Habilidade: assistant-mail no ClawHub. O mesmo MCP funciona com o Hermes.

Instalação

npx -y @assistantmail/assistantmail-mcp

Node 24+.

Claude Desktop

{
  "mcpServers": {
    "assistantmail": {
      "command": "npx",
      "args": ["-y", "@assistantmail/assistantmail-mcp"],
      "env": {
        "ASSISTANT_MAIL_API_KEY": "amk_..."
      }
    }
  }
}

Cursor / VS Code (.cursor/mcp.json ou .vscode/mcp.json)

{
  "servers": {
    "assistantmail": {
      "command": "npx",
      "args": ["-y", "@assistantmail/assistantmail-mcp"],
      "env": {
        "ASSISTANT_MAIL_API_KEY": "amk_..."
      }
    }
  }
}

Pré-requisitos

1. Crie uma conta gratuita pelo link Obtenha Grátis acima (1 agente, 25/dia; limites atuais: Documentação).
2. Vá em API Keys e crie uma chave (amk_...). Copie-a imediatamente — ela é exibida apenas uma vez.
3. Defina ASSISTANT_MAIL_API_KEY; chame assistantmail_list_mailboxes para obter seu UUID de mailboxId. As rotas da API de e-mail usam esse UUID, não um endereço de e-mail.

Planos pagos: upgrade apenas no aplicativo (não por Payment Links). Use Upgrade no aplicativo AssistantMail — o checkout não é vendido via Stripe Payment Links. Documentação: assistant-mail.ai/docs

Registro Oficial MCP

A listagem está ativa como io.github.AssistantMail/assistantmail-mcp no Registro Oficial MCP. Documentação do produto: assistant-mail.ai/docs.

O empacotamento está em server.json. Após um aumento de versão, republique com mcp-publisher — veja docs/MCP_REGISTRY.md.

Variáveis de ambiente

Variável	Padrão	Descrição
ASSISTANT_MAIL_API_KEY	(nenhum)	Chave da API (amk_...). Pode ser omitida se for passada por ferramenta.
ASSISTANT_MAIL_API_BASE_URL	https://api.assistant-mail.ai	A API pública para o serviço AssistantMail

Ferramentas

Diagnóstico

Ferramenta	Descrição
assistantmail_health	Verifica se o servidor MCP está em execução e confirma a URL base da API. Nenhuma chave de API é necessária.

Conta

Ferramenta	Descrição
assistantmail_get_me	Obtém o perfil da conta e o nível do plano.
assistantmail_get_inbound_policy	Obtém a política atual de e-mail de entrada (quem pode enviar para as caixas de correio desta conta).
assistantmail_update_inbound_policy	Atualiza a política de entrada (se permitido pelo nível da conta selecionado). Valores aceitos: owner, list, sent. Use allowedSenders com list.

Caixas de correio

Ferramenta	Descrição
assistantmail_list_mailboxes	Lista todas as caixas de correio da conta. Retorna mailboxId necessário para operações de mensagens.
assistantmail_create_mailbox	Cria uma nova caixa de correio (se permitido pelo nível da conta selecionado), opcionalmente especificando displayName e address.
assistantmail_get_mailbox	Obtém metadados de uma única caixa de correio por mailboxId.
assistantmail_update_mailbox	Atualiza o nome de exibição de uma caixa de correio.
assistantmail_delete_mailbox	Exclui permanentemente uma caixa de correio e todas as suas mensagens. ESTA AÇÃO NÃO TEM CONFIRMAÇÃO. USE COM CUIDADO.

Mensagens

Ferramenta	Descrição
assistantmail_list_messages	Lista mensagens de entrada e saída de uma caixa de correio. Suporta since (timestamp ISO) e limit (máx. 100).
assistantmail_get_message	Busca uma única mensagem incluindo textBody e htmlBody. Os corpos são retornados apenas dentro da janela de retenção do plano; bodyExpired: true é definido se a janela expirou.
assistantmail_send_email	Enfileira um e-mail de saída. Requer to, subject e pelo menos um de text ou html.
assistantmail_reply_message	Responde a uma mensagem existente. Requer messageId e pelo menos um de text ou html; destinatários e assunto são derivados automaticamente.
assistantmail_delete_messages	Exclui mensagens por array de messageIds, ou passe deleteAll: true para limpar a caixa de correio.
assistantmail_get_usage	Obtém o uso da cota de envio diária e mensal de uma caixa de correio. Um limite de null significa ilimitado.

Destinatários

Ferramenta	Descrição
assistantmail_list_recipients	Lista destinatários aprovados e pendentes da conta.
assistantmail_add_recipient	Adiciona um destinatário. Envia um e-mail de convite de consentimento quando exigido pelo plano da conta.
assistantmail_remove_recipient	Remove um destinatário da lista permitida.

Ferramentas de referência

Estas retornam detalhes brutos dos endpoints REST em vez de chamar a API. Use-as quando precisar construir uma solicitação manualmente ou inspecionar a URL exata e o esquema de resposta.

Ferramenta	Descrição
assistantmail_send_email_reference	Endpoint, cabeçalhos e campos do corpo para POST /v1/mailboxes/{mailboxId}/messages.
assistantmail_list_messages_reference	Endpoint e parâmetros de consulta para GET /v1/mailboxes/{mailboxId}/messages.
assistantmail_get_message_reference	Endpoint e esquema de resposta para GET /v1/mailboxes/{mailboxId}/messages/{messageId}.
assistantmail_get_usage_reference	Endpoint e esquema de resposta para GET /v1/mailboxes/{mailboxId}/usage.

Início rápido

API_KEY="amk_..."
BASE="https://api.assistant-mail.ai"

# 1) Discover your mailboxId
curl "$BASE/v1/mailboxes" -H "x-api-key: $API_KEY"

# 2) Send an email
curl -X POST "$BASE/v1/mailboxes/<mailboxId>/messages" \
  -H "x-api-key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"to":"recipient@example.com","subject":"Hello","text":"Hi there"}'

# 3) Read inbox
curl "$BASE/v1/mailboxes/<mailboxId>/messages" -H "x-api-key: $API_KEY"

Exemplos de chamadas de ferramentas

{ "tool": "assistantmail_list_mailboxes", "input": { "apiKey": "amk_..." } }

{
  "tool": "assistantmail_list_messages",
  "input": { "mailboxId": "<uuid>", "limit": 20, "since": "2026-01-01T00:00:00.000Z" }
}

{
  "tool": "assistantmail_get_message",
  "input": { "mailboxId": "<uuid>", "messageId": "<uuid>" }
}

{
  "tool": "assistantmail_send_email",
  "input": {
    "mailboxId": "<uuid>",
    "to": "recipient@example.com",
    "subject": "Hello",
    "text": "Hi there"
  }
}

{
  "tool": "assistantmail_reply_message",
  "input": {
    "mailboxId": "<uuid>",
    "messageId": "<uuid>",
    "text": "Thanks for the update."
  }
}

Se ASSISTANT_MAIL_API_KEY estiver definido no ambiente do servidor, apiKey pode ser omitido de todas as entradas das ferramentas.

---

AssistantMail · Política de Privacidade · Termos de Uso