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

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