Skip to main content
Glama
deenesjakoruzh
storesace-cv

MCP Mail

by storesace-cv
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

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.

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • mcp-email

    OneShotForge
    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.
    -

  • Gmail MCP Server

    jsflax
    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.
    89 npm
    1
    MIT

  • outlook-triage-mcp

    giuseppeferretti
    A
    license
    A
    quality
    C
    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

  • email-mcp

    skyttedk
    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.
    -