Skip to main content
Glama
MCP Mail

MCP Mail

by storesace-cv

MCP Mail · bwb.pt

Self-hosted claude-mail-mcp connector for Claude.ai, with:

  • OAuth 2.1 + DCR + PKCE shim (Claude.ai Custom Connector)

  • Backoffice at https://mcp-mail.bwb.pt/admin for multi-account IMAP/SMTP management

  • BWB Comms at https://comms.bwb.pt/admin — ingest autónomo (unanswered, facturas, WhatsApp allowlist, KB). Deploy: bash deploy/install-comms.sh

  • Hardened nginx + systemd on Ubuntu 24.04

Architecture

Claude.ai ──HTTPS/OAuth──▶ nginx (mcp-mail.bwb.pt)
                              ├─ /health  → claude-mail-mcp :3220
                              └─ /*       → oauth-shim+admin :3221 ──Bearer──▶ :3220

Related MCP server: Gmail MCP Server

Local development

cp deploy/env/shim.env.example .env
# adjust STATE_DIR to a local path, SESSION_SECRET, AUTH_TOKEN
npm install
npm run build
npm start

Production deploy

On the VPS (as root), from this repo checkout:

bash deploy/install.sh

Then open https://mcp-mail.bwb.pt/admin, login, change the temporary password, add mailbox accounts.

Claude.ai → Settings → Connectors → Add custom → URL https://mcp-mail.bwb.pt/mcp.

Ops

See docs/OPERATIONS.md and docs/ROADMAP.md.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      Self-hosted MCP server for any IMAP/SMTP inbox. Multi-account in one config. Built for Claude Code.
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      An MCP server that provides Claude with access to your Gmail, featuring a full OAuth 2.1 authorization server with dynamic client registration and tools to list, read, search, send, reply, draft, archive, trash, manage labels, and download attachments.
      239 npm
      1
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      MCP server that connects Claude to Microsoft 365 mail for inbox triage, search, classification, and idempotent rule provisioning via Microsoft Graph, with device-code auth and read-only default.
      6
      1
      MIT
    • F
      license
      Not graded
      quality
      C
      maintenance
      Local IMAP/SMTP MCP server that lets Claude read, search, draft, send, flag, and move mail across multiple IMAP mailboxes. Credentials stay on your machine.
      -