Earth Class Mail MCP
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Earth Class Mail MCP show me my unread mail"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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-mcpGet 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 |
| Get your account info |
| List all your mailboxes |
| List mail in an inbox |
| Get details + scanned content for a piece |
| List names on a mailbox |
| Scan, shred, ship, archive, etc. |
| 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-mcpOr 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
Log in to Earth Class Mail
Go to Settings (gear icon)
Click Integrations tab
Under "Custom API integration", click Generate Key
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 toolsecm_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
Scored across 8 tools
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.
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.
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.
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
Related MCP Connectors
Send and read email, and set up domains, mailboxes, pacing and webhooks on AI Inbx.
Read Click2Mail credit, jobs, costs and tracking; upload documents, create and submit mail jobs.
Send and receive email, and manage templates, inboxes, contacts and broadcasts.
Send and receive email from your verified domains; manage domains, templates and deliverability.
Related MCP Servers
- AlicenseAqualityBmaintenanceManages email accounts via IMAP/SMTP, enabling reading, searching, sending, replying, forwarding, and folder management with multi-user and OAuth support.222MIT
- AlicenseAqualityCmaintenanceMCP 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.211MIT
- AlicenseNot gradedqualityAmaintenanceEnables 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 npmISC
- AlicenseNot gradedqualityAmaintenanceEnables 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 npmISC