Skip to main content
Glama
Earth Class Mail MCP

Earth Class Mail MCP

by usiegj00

Earth Class Mail MCP

Access your Earth Class Mail virtual mailbox from Claude.

Quick Install

Claude Desktop: Download earthclassmail.dxt and double-click to install.

Claude Code:

claude mcp add earthclassmail -e EARTHCLASSMAIL_API_KEY=your-key -- npx -y @usiegj00/earthclassmail-mcp

Get your API key from Earth Class Mail: Settings → Integrations → Generate Key


Related MCP server: dropscan-mcp

What You Can Do

  • List inboxes and see unread mail counts

  • View mail pieces with envelope images and sender info

  • Get scanned content (PDFs) for opened mail

  • Request actions: scan, shred, ship, archive, trash

  • Manage recipients on your mailbox

Tools

Tool

Description

ecm_get_user

Get your account info

ecm_list_inboxes

List all your mailboxes

ecm_list_pieces

List mail in an inbox

ecm_get_piece

Get details + scanned content for a piece

ecm_list_recipients

List names on a mailbox

ecm_perform_action

Scan, shred, ship, archive, etc.

ecm_get_piece_content

Get scanned PDF/image content

Manual Installation

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "earthclassmail": {
      "command": "npx",
      "args": ["-y", "@usiegj00/earthclassmail-mcp"],
      "env": {
        "EARTHCLASSMAIL_API_KEY": "your-api-key-here"
      }
    }
  }
}

Claude Code

claude mcp add earthclassmail -e EARTHCLASSMAIL_API_KEY=your-key -- npx -y @usiegj00/earthclassmail-mcp

Or add to ~/.claude/settings.json:

{
  "mcpServers": {
    "earthclassmail": {
      "command": "npx",
      "args": ["-y", "@usiegj00/earthclassmail-mcp"],
      "env": {
        "EARTHCLASSMAIL_API_KEY": "your-api-key-here"
      }
    }
  }
}

Getting Your API Key

  1. Log in to Earth Class Mail

  2. Go to Settings (gear icon)

  3. Click Integrations tab

  4. Under "Custom API integration", click Generate Key

  5. Copy the key (a UUID like xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx)

Example Usage

"Show me my unread mail"

"What mail did I receive this week from the IRS?"

"Request a scan of piece 12345678"

"Shred all the junk mail in my inbox"

License

MIT

Available Tools

8 tools
ecm_get_inboxA

Get details for a specific inbox including account info and piece counts

Inputs: inbox_id (required).

ecm_get_pieceB

Get detailed information about a specific mail piece including scanned content URLs

Inputs: piece_id (required), include_media.

ecm_get_piece_contentA

Get scanned content (PDF or images) from a mail piece. Returns the scanned PDF document and/or envelope images.

Inputs: piece_id (required), content_type.

ecm_get_userA

Get the current Earth Class Mail user profile information

Inputs: no named parameters.

ecm_list_inboxesA

List all mailbox inboxes in your Earth Class Mail account with piece counts

Inputs: no named parameters.

ecm_list_piecesA

List mail pieces in an inbox. Returns a summary of each piece (use ecm_get_piece for full details including media URLs).

Inputs: inbox_id (required), page, per_page, unread_only.

ecm_list_recipientsA

List all recipients (names on your mailbox) for an inbox

Inputs: inbox_id (required).

ecm_perform_actionA

Perform an action on a mail piece. Working actions: scan, shred, ship, archive. Note: move-to-inbox and some other actions may not be available via API.

Inputs: action (required), piece_id (required).

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    A4/5.0

    Scored across 8 tools

    Disambiguation4/5

    Most tools target clearly distinct entities and operations, but ecm_get_piece and ecm_get_piece_content both involve scanned content and could be confused. The descriptions help separate metadata/URLs from actual PDF/image retrieval, but the boundary is slightly fuzzy.

    Naming Consistency5/5

    All tools share the ecm_ prefix and follow a consistent verb_noun snake_case pattern such as list_inboxes, get_piece, and perform_action. The naming is predictable and easy to navigate.

    Tool Count5/5

    Eight tools is well-scoped for the domain, covering user info, inboxes, pieces, recipients, content retrieval, and actions with no bloat. Each tool earns its place in the set.

    Completeness5/5

    The core mail piece workflow is fully covered: list inboxes and pieces, retrieve detailed piece information and scanned content, list recipients, and perform actions like scan, shred, ship, and archive. There are no obvious dead ends or missing operations within the stated domain.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      Manages email accounts via IMAP/SMTP, enabling reading, searching, sending, replying, forwarding, and folder management with multi-user and OAuth support.
      22
      2
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      MCP server for the Dropscan postal-mail-to-email API. It enables reading and managing physical mail items, including listing, downloading scans, and (when explicitly enabled) executing actions like forwarding or destroying letters.
      21
      1
      MIT
    • A
      license
      Not graded
      quality
      A
      maintenance
      Enables AI assistants to read, search, send, reply, forward, schedule, organize, and analyze email across multiple IMAP/SMTP accounts, with provider-aware labels, drafts, templates, and bulk operations. Additional capabilities include real-time IMAP IDLE watching with AI triage, verification-code capture, calendar extraction, analytics, and optional Streamable HTTP or OAuth2 access.
      31 npm
      ISC
    • A
      license
      Not graded
      quality
      A
      maintenance
      Enables AI assistants to read, search, send, schedule, and organize messages across multiple IMAP/SMTP accounts, with real-time inbox watching, verification-code capture, calendar extraction, and analytics. It supports provider-aware label management, OAuth2, and both local stdio and networked Streamable HTTP transports.
      31 npm
      ISC