Mail-MCP

Install

Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/rixtayz-mail-mcp

About

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list, install config and code. Checked Oct 26, 2026.

Tools

4 read · 3 write · 2 delete

Secrets

None asked for

Install scripts

None found

Runs as

Node.js package

Tools (9)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

• mail_bulk_by_senderBulk action by sendercan change or delete data

  Move or delete EVERY message from a sender (exact address) in a folder (Inbox by default). Use `dryRun: true` first to learn how many messages match. Deletion goes to Deleted Items unless `permanent: true`.

• mail_create_folderCreate folder

  Create an Outlook folder (at the root or under a parent). Idempotent: if a folder with the same name already exists it is returned without error. Example: { name: "Newsletters" } or { name: "2025", parent: "Invoices" }.

• mail_deleteDelete messagescan change or delete data

  Delete one or more messages (up to 500 ids). By default messages go to Deleted Items (recoverable with mail_search folder=deleteditems then mail_move; their id changes). `permanent: true` deletes irreversibly: only use it when the user explicitly asks for it.

• mail_get_messageRead a messageread-only

  Return the full content of one message (body converted to text, recipients, attachment flag, web link) plus the unsubscribe options found in its headers (https, mailto, one-click). The body is truncated at 25,000 characters.

• mail_list_foldersList foldersread-only

  List every folder of the Outlook.com mailbox with its path, total message count and unread count. Call it before filing messages to learn which folders exist. Other tools accept a folder by display name ("Invoices"), by path ("Archive/2024"), by well-known name (inbox, deleteditems, junkemail, archive) or by id.

• mail_moveMove messages

  Move one or more messages (up to 500 ids) to a folder (name, path or id). Used for filing. NOTE: Outlook assigns a new id to every moved message; the `moved` result maps old id → new id. To move every message from a sender, prefer mail_bulk_by_sender.

• mail_searchSearch messagesread-only

  List messages of a folder (Inbox by default), newest first, with filters: exact sender, date range, unread only. `query` runs a full-text search (subject, body, sender) and cannot be combined with the other filters. Returns a compact summary (id, sender, subject, date, preview); use mail_get_message for the full content. To page, pass `cursor` back verbatim. For a whole-mailbox view by sender, prefer mail_senders_summary.

• mail_senders_summarySummary by senderread-only

  KEY TOOL FOR TRIAGE. Scans a whole folder (Inbox by default) and aggregates messages by sender: count, unread, latest message, and for the `top` senders the available unsubscribe method (oneClick / https / mailto). Sorted by volume. The scan is cached for the session. Follow up with mail_unsubscribe(lastMessageId) and mail_bulk_by_sender(address).

• mail_unsubscribeUnsubscribe

  Try to unsubscribe from the mailing list of a message, in order: (1) RFC 8058 one-click HTTPS POST, (2) automatic email to the List-Unsubscribe mailto address, (3) otherwise returns `method: "browser"` with the URL to open in a browser to finish manually, (4) `method: "none"` when no header exists. Deletes nothing. Preferably pass the `lastMessageId` returned by mail_senders_summary.

Signals

Stars

1

Forks

0

Open issues

0

Last commit

Oct 1, 2026 (1 month ago)

Last release

Oct 1, 2026 (1 month ago)

From GitHub (fetched Oct 24, 2026).

Details

Registry name

io.github.Rixtayz/mail-mcp

Version

0.1.2

Auth

No auth

Packages

npm @rixtay/mail-mcp

License

MIT

Repository

github.com/Rixtayz/Mail-MCP

Website

github.com/Rixtayz/Mail-MCP#readme

First seen

Oct 24, 2026

Last checked

Oct 24, 2026

Source

Official MCP Registrygithub-graphql