convez.ai
MCP ServerDevOps & InfraestruturaAvançado
maximeoliv

MCP Mailcow

maximeoliv/mcp-mailcow

Controle seu Mailcow pelo Claude com operações de usuário e admin

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP para administração completa do Mailcow direto do Claude. Gerencia caixas de correio, aliases, domínios, senhas de aplicativo e quotas através de uma interface de protocolo padrão.

Instalação

$npx convez-ai maximeoliv/mcp-mailcow

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
1
Forks
2
Acompanhando
0
Saúde
71%
Último commit
há 1 semana
Versão
—
Issues abertas
1
Contribuidores
1

Casos de uso

  • Gerenciar caixas de correio e aliases através do Claude
  • Automatizar operações administrativas de servidor de email
  • Integrar Mailcow com fluxos de trabalho de IA em Claude

Veredito

Ferramenta robusta para administradores de Mailcow que precisam de controle programático via IA. Implementação madura com modos user/admin separados, auditoria e práticas de segurança bem pensadas (app passwords, confirmação de operações destrutivas).

README

A tradução para o português deste README ainda está na fila.

mcp-mailcow

PyPI npm License: MIT

Model Context Protocol server for Mailcow. Pilot your Mailcow instance from Claude (or any MCP-compatible client): read/send mail, manage mailboxes, aliases, domains, app passwords.

This is a BYOK (Bring Your Own Keys) package — install it on your own machine, point it at your Mailcow, use your credentials.

Features

User mode (mailbox operations)

  • Read inbox, search messages, download attachments
  • Send mail, reply to messages
  • Mark read/unread/flagged, move, delete

Admin mode (server operations)

  • Manage mailboxes (create / list / update / delete / quota)
  • Manage aliases (create / list / delete)
  • Manage domains (list / create)
  • Manage app passwords (list / create / delete with protocol scoping)
  • Quota reports, deliverability tests, server status

Install

Python (recommended)

# Zero-install with uvx (recommended)
uvx mcp-mailcow --mode user

# Or pip install
pip install mcp-mailcow

Node / TypeScript

npm install -g mcp-mailcow
# or use npx
npx mcp-mailcow --mode user

Configuration

Claude Desktop / Claude Code

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "mailcow-mailbox": {
      "command": "uvx",
      "args": ["mcp-mailcow", "--mode", "user"],
      "env": {
        "MAILCOW_HOST": "mail.example.com",
        "MAILCOW_MAIL_USER": "you@example.com",
        "MAILCOW_MAIL_PASS": "your-app-password"
      }
    },
    "mailcow-admin": {
      "command": "uvx",
      "args": ["mcp-mailcow", "--mode", "admin"],
      "env": {
        "MAILCOW_ADMIN_URL": "https://mail.example.com",
        "MAILCOW_ADMIN_API_KEY": "your-api-key"
      }
    }
  }
}

You can run both modes simultaneously (each gets its own server entry).

Environment variables

User mode

VariableRequiredDescription
MAILCOW_HOSTyesMailcow hostname (e.g. mail.example.com)
MAILCOW_MAIL_USERyesFull email address (e.g. you@example.com)
MAILCOW_MAIL_PASSyesApp password (recommended) or main password
MAILCOW_IMAP_PORTnoDefault 993 (IMAPS)
MAILCOW_SMTP_PORTnoDefault 587 (STARTTLS)

Admin mode

VariableRequiredDescription
MAILCOW_ADMIN_URLyesBase URL (e.g. https://mail.example.com)
MAILCOW_ADMIN_API_KEYyesMailcow API key (admin → Configuration → Access → API)

Common

VariableDefaultDescription
MCP_MAILCOW_AUDIT_LOG~/.local/state/mcp-mailcow/audit.logAudit log path (JSONL)
MCP_MAILCOW_TLS_VERIFYtrueSet to false only for self-signed certs (not recommended)

Security best practices

  1. Use app passwords, not your main mailbox password. In Mailcow: mailbox → app passwords → create, scope to IMAP+SMTP only.

  2. Use a Read-Only API key for admin mode if you only need to query. (Set API_KEY_READ_ONLY instead of API_KEY in mailcow.conf.)

  3. Audit log review: tail ~/.local/state/mcp-mailcow/audit.log periodically.

  4. Destructive operations (mailbox_delete, alias_delete) require an explicit confirm: true parameter. The server refuses without it.

Development

This is a monorepo with parallel Python and TypeScript implementations. Both share a common tool schema (tools-schema.yaml) as source of truth.

mcp-mailcow/
├── tools-schema.yaml       ← source of truth (read by both impls at build time)
├── py/                     ← Python implementation (PyPI)
├── node/                   ← TypeScript implementation (npm)
└── shared/                 ← shared mocks, integration tests

See CONTRIBUTING.md for setup and contribution guidelines.

License

MIT — see LICENSE.

Ver o original no GitHub

Bom para

Relacionados