send_emailLABSCO SUMMARY
An agent can send the mail, attachment and all.
The pairing is the point: it finds the file from a fragment of its name inside the directory you allowed, then attaches it and sends. "Email Dana the invoice from last week" does not need you to locate the file first.
What it is
An SMTP sender with a file finder next to it. One call composes and sends an email to a list of recipients with optional attachments; the other searches the directory you nominated for filenames matching a pattern.
What you get
- An email sent with subject, body and multiple recipients
- Attachments included by filename
- Files in the nominated directory found by a pattern in their name
- SMTP host and port resolved from the sender's domain through an email.json you edit — Gmail, Outlook and Yahoo are configured out of the box
Requirements
Python with pydantic and python-dotenv, an email.json listing the SMTP server and port for your domain, and the attachment directory named on the launch command. Sending uses your own mailbox credentials.
Setup effort
One command plus credentials — uvx mcp-server-email, then supply credentials
USE CASES
01
Sending a note without switching to the mail client
Dictate the recipients, subject and body, and have it go out over SMTP from the conversation you are already in.
02
Attaching a file you only half remember the name of
Search the attachment directory on a fragment of the filename, confirm the match, then send it.
03
Getting the same message out to a list of people
Pass all the recipients in one call rather than composing the message once per person.
04
Checking a file is where you think before you send
Run the pattern search on its own, so a missing attachment is found before the email goes out rather than after.
2 tools
Listed in project docs. Your client may show a different list.
search_attachmentsBEFORE YOU INSTALL
What to know first
Tools you get
2 tools named in the project's documentation.
Requires
uvx on PATH; SENDER in your environment; PASSWORD in your environment
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
Server setup
TERMINAL
uvx mcp-server-emailMCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"email": {
"command": "uvx",
"args": [
"mcp-server-email",
"--dir",
"/path/to/attachment/directory"
],
"env": {
"SENDER": "YourEmail@gmail.com",
"PASSWORD": "YourAppPassword"
}
}
}
}--dir is the folder search_attachments may look in. PASSWORD is your mailbox password — for Gmail, an app password.
