plugin-imap (1.0.0)

Published 2026-08-16 10:24:02 +00:00 by kai-waggeling in waggeling.net/mcp-plugins

Setup this registry in your project .npmrc file:

registry=

To install the package using npm, run the following command:

npm install plugin-imap@1.0.0

or add it to the package.json file:

"plugin-imap": "1.0.0"

For more information on the npm registry, see the documentation.

IMAP

Read and manage email via IMAP (imapflow + mailparser): mailboxes, list/search/read messages, flags, move and delete

Key	Label	Type	Required	Default
`host`	Host	string	yes	–
`port`	Port	number	no	993
`user`	User	string	yes	–
`password`	Password	secret	yes	–
`secure`	Use TLS (port 993)	boolean	no	true
`rejectUnauthorized`	Verify TLS certificate	boolean	no	true

Key	Label	Type	Required	Default
`timeoutMs`	Timeout (ms)	number	no	15000
`defaultMailbox`	Default mailbox	string	no	INBOX
`maxFetchBytes`	Max text/HTML bytes per fetched message	number	no	1048576
`listLimit`	Max messages per list/search result	number	no	200
`maxAttachmentBytes`	Max attachment size returned as base64 (bytes)	number	no	5242880

Tool	Description
`imap_ping`	Connects to the IMAP server, authenticates and reports connection details (server greeting, capabilities, message count of the default mailbox)
`imap_list_mailboxes`	Lists all mailboxes/folders of the account with their flags and delimiter
`imap_list_messages`	Lists messages of a mailbox (envelope: from/subject/date, flags, size). Select by uids, date range (since/before, internal date) or the newest count messages
`imap_read`	Fetches one message by uid: headers, plain text and HTML body (capped at maxFetchBytes) and attachment metadata. Set attachments=true to also get base64 content (capped at maxAttachmentBytes). Does not mark the message as seen unless markSeen=true
`imap_search`	Searches messages in a mailbox and returns matching uids (newest last, capped at listLimit). Criteria: from, to, subject, text, since/before (internal date), unseen/seen, flagged/unflagged, answered/unanswered
`imap_set_flags`	Adds, removes or sets flags on messages. Flag names: seen, flagged, answered, deleted, draft (case-insensitive; raw IMAP flags like \Seen are passed through)
`imap_move`	Moves messages to another mailbox
`imap_delete`	Marks messages as \Deleted and expunges them (permanently removes them from the mailbox)

Dependencies

ID	Version
imapflow	^1.6.0
mailparser	^3.9.0

Details

npm

2026-08-16 10:24:02 +00:00

Kai

latest

5.6 KiB

Assets (1)

plugin-imap-1.0.0.tgz 5.6 KiB

Versions (3) View all

2026-08-16

2026-08-16

1.0.0

2026-08-16