mcs-driver-mail
Composite mail driver for the Model Context Standard (MCS).
Combines mcs-driver-mailread and mcs-driver-mailsend into a single driver
that exposes all 9 tools (7 read + 2 send). This demonstrates the MCS driver
stacking / composition pattern -- build focused drivers, then combine them.
Installation
pip install mcs-driver-mail
# With IMAP + SMTP adapters
pip install mcs-driver-mail[imap,smtp]
# Everything including inspector
pip install mcs-driver-mail[all]
Quick start
from mcs.driver.mail import MailToolDriver
td = MailToolDriver(
read_adapter="imap",
send_adapter="smtp",
read_kwargs=dict(host="imap.example.com", user="alice@example.com", password="..."),
send_kwargs=dict(host="smtp.example.com", user="alice@example.com", password="...",
sender_name="Alice Smith"),
)
tools = td.list_tools() # 9 tools (7 read + 2 send)
td.execute_tool("list_folders", {})
td.execute_tool("send_message", {"to": "bob@example.com", "subject": "Hi", "body": "Hello"})
Tools
| Tool | Source | Description |
|---|---|---|
list_folders |
mailread | List all mailbox folders |
list_messages |
mailread | List message summaries in a folder |
fetch_message |
mailread | Fetch a full message by UID |
search_messages |
mailread | Search messages by criteria |
move_message |
mailread | Move a message to another folder |
set_flags |
mailread | Add or remove flags on a message |
create_folder |
mailread | Create a new mailbox folder |
send_message |
mailsend | Send a plain-text e-mail |
send_html_message |
mailsend | Send an HTML e-mail with text fallback |
Architecture
mcs-driver-mail (composite)
├── mcs-driver-mailread ← mcs-adapter-imap (or Gmail, Graph, ...)
└── mcs-driver-mailsend ← mcs-adapter-smtp (or Gmail, Graph, ...)
Each sub-driver is protocol-agnostic -- swap adapters without changing driver code.
Links
- Homepage: https://www.modelcontextstandard.io
- Source: https://github.com/modelcontextstandard/python-sdk
License
Apache-2.0
Metadata
Release files for mcs-driver-mail 0.1.5
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| mcs_driver_mail-0.1.5.tar.gz | 12.1 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| mcs_driver_mail-0.1.5-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 23.1 kB
Release files / mcs_driver_mail-0.1.5.tar.gz
| Download URL | mcs_driver_mail-0.1.5.tar.gz |
|---|---|
| Size | 12.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
f2d40f653dd37dd875f3719fba75e5799b25e8cf9008a2444d94f5f584eeff84
|
|
BLAKE2b-256 checksum How to use checksums |
6af579dfeb537222108e33b49ec0cd49ee12f1d3d2149680c138f718ab51f292
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.14.3
|
Release files / mcs_driver_mail-0.1.5-py3-none-any.whl
| Download URL | mcs_driver_mail-0.1.5-py3-none-any.whl |
|---|---|
| Size | 11.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
a1ab8b5d6223e37a0f87515daad986c028a49a46c5947799f35270da483353ad
|
|
BLAKE2b-256 checksum How to use checksums |
6053dd62aeec4018cb5ec15e5b64c4eff0f224da76bc728fb3898f0d18bbccf6
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.14.3
|