Mailing Manager

📋 Overview

Mailing Manager MCP is the most advanced, secure, and production-ready Model Context Protocol (MCP) server for email management. Designed for AI agents (Gemini, Claude, GPT), it transforms your mailboxes into a structured, searchable, and intelligent memory bank.

It allows AI assistants like Claude and Cursor to manage multiple email accounts with advanced features while keeping your credentials ultra-secure.

🌟 Killer Features

🔐 Universal Secure Handshake (A+B+C)

Configure any account safely across any environment:

• Method A (Local): Fast setup via local browser.
• Method B (Direct): Quick injection for trusted environments.
• Method C (Public Tunnel): Configures remote clients (n8n, mobile) via secure temporary SSH tunnels (Pinggy).

🧠 FTS5 Local AI Memory

Don't let your AI drown in tokens. Mailing Manager syncs your emails to a Local SQLite Full-Text Search (FTS5) table:

• Instant Search: Sub-millisecond lookups across all accounts.
• Token Optimization: Extracts clean text, removing heavy HTML and technical headers.
• Attachment Awareness: The AI sees what's available to download without fetching binaries.

🔄 Delta Synchronization

Intelligent incremental sync logic that only fetches what's new.

• Performance: Syncs newest first and stops at the last known email.
• Control: Configurable limits (Default 30, Max 100 per session).
• Sync Status: View last synced UID, total count, and date range with get_sync_status.
• Reset Sync: Clear local cache and force full re-sync with reset_sync.

🧵 Thread-Aware Intelligence (v1.1.0)

Smart conversation threading for context-rich AI replies:

• Thread Detection: Auto-detects conversations via Message-ID, In-Reply-To, and References headers.
• Thread Fetching: get_email_thread retrieves all emails in a conversation chronologically.
• Thread Summary: get_thread_summary generates condensed summaries (key participants, topic, timeline).
• Auto-Context Injection: Reply with thread_aware: true to automatically inject thread history into your reply body.

📜 360° Activity Audit

Full transparency for both the user and the AI. Every action is logged in a dedicated activity journal:

• Read/Sent: Know exactly what was accessed or dispatched.
• Sync/Download: Track background memory updates and file transfers.
• Task/Directive: Monitor automated workflows.

🚀 Installation

Option 1: Global Install (NPM)

npm install -g @tatine13/mcp-manager

Option 2: Local Install (Development)

git clone https://github.com/Tatine13/mailing-manager-mcp.git
cd mailing-manager-mcp
npm install
npm run build

🗝️ First-Time Setup

Create your encryption password (used to secure your local SQLite DB):

# Set your unlock code in your environment
export MAILING_MANAGER_UNLOCK_CODE="your-secure-password"

# Run the setup wizard
mailing-manager setup
# (Or 'node dist/bin/cli.js setup' if running locally)

⚙️ Configuration

Add Mailing Manager to your MCP client (Gemini CLI, Claude Desktop, or Cursor).

A. Using NPM (Easiest)

{
  "mcpServers": {
    "mailing-manager": {
      "command": "npx",
      "args": ["-y", "@tatine13/mcp-manager", "server"],
      "env": {
        "MAILING_MANAGER_UNLOCK_CODE": "your-secure-password",
        "MAILING_MANAGER_SYNC_LIMIT": "50",
        "LOG_LEVEL": "info"
      }
    }
  }
}

B. Using Local Build

{
  "mcpServers": {
    "mailing-manager": {
      "command": "node",
      "args": ["/ABS_PATH_TO_PROJECT/dist/bin/server.js"],
      "env": {
        "MAILING_MANAGER_UNLOCK_CODE": "your-secure-password",
        "MAILING_MANAGER_SYNC_LIMIT": "50"
      }
    }
  }
}

📬 Multi-Account Support

• Unlimited email accounts
• Provider Presets: Gmail, Outlook, Yahoo, iCloud, Fastmail, Custom
• Authentication Methods: App Passwords, Password (OAuth2 support planned for v1.5)
• Protocols: IMAP, SMTP with TLS

🛠️ Available Tools (38)

👤 Account & Provider Management

📧 Email Operations (IMAP/SMTP)

🧠 Local Memory & Audit

🎭 AI Personas

📋 Automation Directives

⚙️ Scheduled Tasks

🔗 Webhooks

🛡️ Security First

• AES-256-GCM: Credentials are never stored in plaintext.
• Argon2id: Military-grade key derivation.
• Vault Architecture: Non-blocking protocol stability.
• Secure Input: Browser-based ephemeral security portal.

📄 License

MIT © Tatine13