Skip to main content

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.

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)

Source distribution for mcs-driver-mail 0.1.5
File Size Uploaded
mcs_driver_mail-0.1.5.tar.gz 12.1 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for mcs-driver-mail 0.1.5
File Interpreter ABI Platform
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

Release history Release notifications | RSS feed

This release

0.1.5 This release

2 release files

0.1.4

2 release files

0.1.3

2 release files

0.1.2

2 release files

0.1.1

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page