Skip to main content

mcs-adapter-imap

IMAP adapter for the Model Context Standard (MCS).

Encapsulates all IMAP wire-level details (imaplib, MIME parsing) behind a clean adapter interface. Drivers like mcs-driver-mailread delegate all mailbox I/O to this adapter so they never touch imaplib directly.

Zero runtime dependencies -- uses only the Python standard library.

Installation

pip install mcs-adapter-imap

Quick start

from mcs.adapter.imap import ImapAdapter

adapter = ImapAdapter(host="imap.example.com", user="alice@example.com", password="...")
folders = adapter.list_folders()
messages = adapter.list_messages("INBOX", limit=10)

Provided methods

Method 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 IMAP 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

Links

License

Apache-2.0

Metadata

Release files for mcs-adapter-imap 0.1.0

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-adapter-imap 0.1.0
File Size Uploaded
mcs_adapter_imap-0.1.0.tar.gz 10.8 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for mcs-adapter-imap 0.1.0
File Interpreter ABI Platform
mcs_adapter_imap-0.1.0-py3-none-any.whl Python 3 none any Details

Total release size: 20.4 kB

Release files / mcs_adapter_imap-0.1.0.tar.gz

Download URL mcs_adapter_imap-0.1.0.tar.gz
Size 10.8 kB
Tags Source
SHA-256 checksum
How to use checksums
cfb9c56f336a5d4023d198f819293e9e7cda6a3443ca853c9c338aea3329e477
BLAKE2b-256 checksum
How to use checksums
24568821c1b0b28ba73d6e002803227671eb3f6d6d6f1f7f5c4216e87b2adf8b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.11.5

Release files / mcs_adapter_imap-0.1.0-py3-none-any.whl

Download URL mcs_adapter_imap-0.1.0-py3-none-any.whl
Size 9.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
c1d7747d0dddf1eae05106f2c4c671fcdef011aed6cf77190f555d933e35bc18
BLAKE2b-256 checksum
How to use checksums
ba155766c23b2b4b6b611ef2c70028e8ccf6723600c2778a49c6647afa2bc896
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.11.5

Release history Release notifications | RSS feed

This release

0.1.0 This release

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