mcs-driver-mailread
Mail-reading driver for the Model Context Standard (MCS).
Provides tools for listing folders, reading messages, searching, moving, and organising e-mail. The actual I/O is delegated to a pluggable adapter, making the same driver work with IMAP, Gmail API, Microsoft Graph, or any future backend.
Installation
pip install mcs-driver-mailread
# With IMAP adapter
pip install mcs-driver-mailread[imap]
Quick start
from mcs.driver.mailread import MailreadToolDriver
# IMAP (default adapter)
td = MailreadToolDriver(
adapter="imap",
host="imap.example.com",
user="alice@example.com",
password="...",
)
tools = td.list_tools() # 7 tools
result = td.execute_tool("list_folders", {})
Tools
| Tool | Description |
|---|---|
list_folders |
List all mailbox folders |
list_messages |
List message summaries in a folder |
fetch_message |
Fetch a full message by UID |
search_messages |
Search messages by criteria |
move_message |
Move a message to another folder |
set_flags |
Add or remove flags on a message |
create_folder |
Create a new mailbox folder |
Adapter protocol
The driver defines a MailboxPort typing protocol. Any object that implements
the seven methods above satisfies the contract -- no inheritance required.
Links
- Homepage: https://www.modelcontextstandard.io
- Source: https://github.com/modelcontextstandard/python-sdk
License
Apache-2.0
1 maintainer
Metadata
1 maintainer
Release files for mcs-driver-mailread 0.2.3
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_mailread-0.2.3.tar.gz | 15.5 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| mcs_driver_mailread-0.2.3-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 29.3 kB
Release files / mcs_driver_mailread-0.2.3.tar.gz
| Download URL | mcs_driver_mailread-0.2.3.tar.gz |
|---|---|
| Size | 15.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
74a82cd1b6231099f93b023c50769d9dbaaf017b9c8e629562f29deae4c6429c
|
|
BLAKE2b-256 checksum How to use checksums |
b9a31a4ea05812e4c37cf3e1ecf20f34524efccab05b4ccc5130659f190544e6
|
| 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_mailread-0.2.3-py3-none-any.whl
| Download URL | mcs_driver_mailread-0.2.3-py3-none-any.whl |
|---|---|
| Size | 13.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
9568065e26ae12b3eac9b0dc199aa0ebc819895f13ff0f25ce031e3a7eb340ef
|
|
BLAKE2b-256 checksum How to use checksums |
b570968b9d1ec6ec6cfaa500f52bfebec9a63d3af675dac7a4ea8ff39efc05de
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.14.3
|
