email-mcp-postale
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Email MCP Server for Postale.io
An MCP server that gives Claude Desktop / Cowork access to your Postale.io email mailboxes. Supports multiple accounts, reading, searching, replying, drafts, deleting, and batch operations.
Features
Tool | Description |
| Show all configured email accounts |
| Show folder structure of an account |
| Fetch unread emails |
| Fetch recent emails from the last X days |
| Read a single email in full |
| Search emails (subject, sender, body) |
| Send an email (with reply threading) |
| Save a draft (visible in Spark) |
| Move an email to another folder |
| Move an email to trash |
| Delete multiple emails at once |
| Mark as read |
| Mark as unread |
| Stats: unread per folder |
| Across ALL accounts: summarize unread |
Related MCP server: IMAP MCP Server
Setup
1. Clone and install dependencies
git clone https://github.com/ssk-machines/email-mcp-postale.git
cd email-mcp-postale
pip install -r requirements.txt
# or with uv:
uv pip install -r requirements.txt2. Create configuration
cp config.json.example config.jsonThen edit config.json β add an account entry for each mailbox:
{
"accounts": [
{
"name": "My Account",
"email": "me@example.com",
"imap_host": "mail.postale.io",
"imap_port": 993,
"smtp_host": "mail.postale.io",
"smtp_port": 465,
"username": "me@example.com",
"password": "your-password"
},
{
"name": "Support",
"email": "support@example.com",
...
}
]
}Tip: On Postale.io, the username is always the full email address.
3. Test
python server.pyIf no errors appear, the server is running correctly in stdio mode.
4. Add to Claude Desktop
Open ~/Library/Application Support/Claude/claude_desktop_config.json and add:
With uv:
{
"mcpServers": {
"email": {
"command": "uv",
"args": [
"--directory", "/path/to/email-mcp-postale",
"run", "server.py"
]
}
}
}Or with Python directly:
{
"mcpServers": {
"email": {
"command": "python3",
"args": ["/path/to/email-mcp-postale/server.py"],
"env": {
"EMAIL_MCP_CONFIG": "/path/to/email-mcp-postale/config.json"
}
}
}
}Replace
/path/to/email-mcp-postalewith the actual path where you cloned the repo.
5. Restart Claude Desktop
After saving the config, fully quit and reopen Claude Desktop. The email connector should appear as active under "Connectors".
Scheduled Tasks (Cowork)
Morning Briefing (daily, 7:00 AM)
Every morning at 7:00 AM:
1. Call get_all_unread_summary to fetch all unread emails across all accounts.
2. Categorize each email as:
- π΄ URGENT: Needs immediate reply (customers, partners, investors)
- π‘ REPLY NEEDED: Needs a reply, but not time-critical
- π’ FYI: Just read, no action needed
- βͺ UNIMPORTANT: Newsletters, marketing, spam
3. Draft a reply for each π΄ and π‘ email using save_draft.
4. Mark βͺ emails as read with mark_as_read.
5. Create a clear summary as a briefing.Cleanup Task (weekly, Friday 5:00 PM)
Every Friday at 5:00 PM:
1. Search all accounts for newsletter and marketing emails from the past week.
2. Create a list for batch deletion.
3. Show me the list for confirmation before deleting.Security Notes
Passwords are stored in plaintext in
config.jsonβ protect the file withchmod 600 config.jsonAlternatively: use Postale.io app passwords (if supported)
Do NOT commit config.json to git
License
MIT
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogβ¦
This server cannot be deployed
Maintenance
Related MCP Connectors
Connect any IMAP/SMTP mailbox to Claude & ChatGPT: search, read, sort, draft. Sends only with OK.
Connect any mailbox to Claude, ChatGPT & AI: read, send, reply, schedule & search emails.
Your mailboxes in ChatGPT and Claude: Gmail, iCloud, Fastmail, any IMAP. Passwords stay yours.
Bring Gmail, Outlook, iCloud Mail, Yahoo Mail, Fastmail and other IMAP mailboxes together. Search connected email, including semantic search; cached or indexed results may be incomplete or stale. Read messages and attachments, create drafts, send or reply when requested, and manage rules for new mail. Separate permissions control reading, attachments, drafts, sending and mailbox changes.
Related MCP Servers
- AlicenseAqualityAmaintenanceEnables Claude to interact with email accounts via IMAP and SMTP, providing tools for searching, reading, sending, and managing emails across multiple providers.40931 npm130MIT
- FlicenseNot gradedqualityDmaintenanceEnables Claude to read, search, send, and manage emails across multiple IMAP/SMTP accounts via a single deployment.-
- AlicenseAqualityCmaintenanceEnables Claude to control the macOS Mail app for reading, searching, drafting, sending, and managing emails directly from Claude Desktop.12MIT
- FlicenseNot gradedqualityBmaintenanceEnables Claude to read, search, draft, send, flag, and move email across multiple IMAP/SMTP mailboxes while keeping credentials local.-