delete_email
Permanently delete an email
LABSCO SUMMARY
The same connection that files your mail can tell you where the volume is coming from.
The reporting tools all work over a trailing number of days rather than an arbitrary date range, and generate_email_analytics will read message bodies when includeContent is set, up to the maxEmails ceiling it is given. On the mailbox side the destructive call is unambiguous: delete_email removes a message permanently, where move_email is the reversible option. Reading and filing address messages and folders by id, so list_mailboxes and list_emails come first in most sequences.
What it is
A Fastmail server covering the mailbox itself and a reporting layer over it, from a single account's credentials.
What you get
- Browse the account: list_mailboxes for the folder tree, list_emails filtered by mailbox, sender, subject, unread state or free text, get_email for one message in full.
- Find a message by its text with search_emails.
- Send with a text or HTML body, cc and bcc, and an inReplyTo reference when the message answers a thread.
- Act on what you found: mark_email_read, move_email to another folder, delete_email.
- Report over a window of days: get_email_volume_stats for sent and received counts, get_top_senders with counts and percentages, get_activity_patterns by hour, day and month, and generate_email_analytics or generate_email_report for the written version.
Requirements
A Fastmail account, with FASTMAIL_EMAIL (your Fastmail address) and FASTMAIL_API_TOKEN in the environment.
Setup effort
One command plus a key — npx -y @alexdiazdecerio/fastmail-mcp-server, then supply credentials
USE CASES
01
Clearing an inbox backlog without opening the mail client
List what is unread, mark off what needs no reply, and file the rest into the folder it belongs in.
02
Answering a thread you only half remember
Search on the phrase you do remember, open the message in full, and reply on the same thread with inReplyTo set.
03
Working out who is actually filling your inbox
Rank senders over a trailing window with counts and percentages, and put the ranking next to the sent and received totals for the same period.
04
Finding the hours of the day that mail is eating
Break activity down by hour, day and month, then take the written version of the same window when it has to be shared with someone.
13 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
generate_email_analytics
Generate comprehensive email analytics and insights for a specified period
generate_email_report
Generate a comprehensive email analytics report with insights and recommendations
get_activity_patterns
Get email activity patterns by hour, day, and month
get_email
Get full details of a specific email including body content
get_email_volume_stats
Get email volume statistics (sent/received counts) for a period
get_top_senders
Get top email senders analysis with counts and percentages
list_emails
List emails from your Fastmail account with optional filters
list_mailboxes
List all email folders/mailboxes in your Fastmail account
mark_email_read
Mark an email as read or unread
move_email
Move an email to a different mailbox/folder
search_emails
Search for emails containing specific text
send_email
Send a new email
BEFORE YOU INSTALL
What to know first
Tools you get
13 tools when we connected.
Requires
- npx on PATH
- FASTMAIL_EMAIL in your environment
- FASTMAIL_API_TOKEN in your environment
CONTEXT COST
Light Standing cost
Rated by the size of the 13 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Add the block to your client, or run the command directly.
Server setup
Configuration file
JSON
{
"mcpServers": {
"fastmail-mcp-server": {
"command": "npx",
"args": [
"-y",
"@alexdiazdecerio/fastmail-mcp-server"
]
}
}
}The server needs FASTMAIL_EMAIL (your Fastmail address) and FASTMAIL_API_TOKEN in its environment. In the client configuration, add both to an "env" object inside the server entry; to run the command directly, set them in your shell first. The token is an API token, not an app password: create one at https://www.fastmail.com/settings/security/tokens with Mail and Submission access (Masked Email optional), and leave Read-only access unticked.
npx
TERMINAL
npx -y @alexdiazdecerio/fastmail-mcp-server
