Mail-MCP server
io.github.Rixtayz/mail-mcp·v0.1.2·1 starsPersonal Outlook.com / Hotmail inbox: read, search, file, delete, unsubscribe via Microsoft Graph.
1 stars4 downloads/wk
Reviews
Write oneNobody has reviewed Mail-MCP yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Mail-MCP tools (9, 2 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
mail_bulk_by_senderMove or delete EVERY message from a sender (exact address) in a folder (Inbox by default).
mail_create_folderwrite actionCreate 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.
mail_deletewrite actionDelete 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).
mail_get_messageReturn the full content of one message (body converted to text, recipients, attachment flag, web link)
mail_list_foldersList every folder of the Outlook.com mailbox with its path, total message count and unread count.
mail_moveMove one or more messages (up to 500 ids) to a folder (name, path or id). Used for filing.
mail_searchList messages of a folder (Inbox by default), newest first, with filters: exact sender, date range, unread only.
mail_senders_summaryKEY TOOL FOR TRIAGE. Scans a whole folder (Inbox by default) and aggregates messages by sender: count, unread, latest message,
mail_unsubscribeTry 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,
Public scan report
scanner v0.1.10 · 2026-10-01 · same rubric, same numbers if you re-run it
- Code scan15 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitylocal package, no credentials required12/15
- Maintenancelast push 0 days ago15/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
How Mail-MCP compares
Against every graded Email MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 92/100
- higher than 90% of 916 Email servers
- Tools
- 9
- the typical Email server has 7
- Tools that change things
- 22%
- typical: 25%. Fewer write tools means less an agent can break
- GitHub stars
- 1
- more than 65% of 493 Email servers
- Downloads a week
- 4
- more than 1% of 235 Email servers with a package
What its tools let an agent do: 7 read · 2 change
Install Mail-MCP in Claude Code, Cursor or VS Code
Runs npx -y @rixtay/mail-mcp on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add mail-mcp -- npx -y @rixtay/mail-mcp
What the publisher says
From the Mail-MCP repository's README, as published. We do not edit it. Read it on GitHub
Mail-MCP
A small, focused MCP server that lets Claude (Claude Desktop, Cowork, Claude Code or any MCP client) work on a personal Outlook.com / Hotmail / Live mailbox through Microsoft Graph: read and search mail, file it into folders, delete it, and unsubscribe from newsletters.
Built for one job: clean up an overflowing personal inbox with an AI assistant, safely.
Tools
Nine tools, all prefixed mail_:
Design choices:
- Safe by default. Deletion goes to Deleted Items (visible and restorable in Outlook). Permanent deletion requires an explicit flag. Bulk actions support dryRun.
- Efficient on big mailboxes. mailsenderssummary scans thousands of messages in a few seconds (1,000-item pages, minimal $select) and only fetches headers for the top senders through $batch.
- No generic send tool. The Mail.Send permission is used solely to send mailto: unsubscribe requests.
- Every tool ships a strict input schema, an output schema and MCP annotations (readOnlyHint, destructiveHint, …) so hosts can auto-approve read-only calls.
Requirements
- Node.js 22 or newer.
- A personal Microsoft account (outlook.com, hotmail.com, live.com, msn.com).
- A free Microsoft Entra app registration (5 minutes, below). Password-based IMAP was switched off for personal accounts in September 2024, so an OAuth app is the only supported way in.
1. Register an app in Microsoft Entra (once, free)
No Azure subscription is needed for a public client app.
- Go to and sign in with your personal Microsoft account.
- Identity → Applications → App registrations → New registration.
- Fill in:
- Name: Mail-MCP
- Supported account types: Personal Microsoft accounts only
- Redirect URI: platform Mobile and desktop applications, value http://localhost
- Click Register and copy the Application (client) ID (xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx).
- Under Authentication, make sure http://localhost is listed under "Mobile and desktop applications" and Allow public client flows is Yes.
- Under API permissions, add Microsoft Graph delegated permissions: Mail.ReadWrite, Mail.Send, User.Read, offline_access. No admin consent is needed; you consent at first sign-in.
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Mail-MCP: common questions
- Is Mail-MCP server safe?
- Yes, by our scan: it is graded A (92/100). Read the Mail-MCP safety report
- How do I install Mail-MCP?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Mail-MCP need an API key?
- No secret keys are declared. It reads 2 settings from the environment.
- Is Mail-MCP maintained?
- The last commit was 34 days ago (2026-10-01). The latest release is v0.1.2.
- What can I use instead of Mail-MCP?
- Servers from other publishers that do the same job: Outlook MCP server, Outlook MCP server and Microsoft 365 Mail MCP server.
- How does Mail-MCP compare with other Email MCP servers?
- safety score 92/100 (higher than 90% of 916 Email servers); tools 9 (the typical Email server has 7); tools that change things 22% (typical: 25%. Fewer write tools means less an agent can break). Full comparison.
Alternatives to Mail-MCP
Same job from other publishers: the closest match first, then the best rated.
- Outlook MCPMicrosoft Outlook personal accounts: mail, rules, calendar, contacts, to-do, drafts (77 tools).not reviewedEstablishedA
- OutlookOutlook & OneDrive MCP: personal & enterprise tools for mail, calendar, contacts, tasks, filesnot reviewedGrowingA
- Microsoft 365 MailMicrosoft 365 Outlook mail via Graph: read, search, send, reply, forward, draft, move, delete.not reviewedGrowingA
- OutlookMicrosoft Outlook MCP server — 20 tools for email, calendar, contacts, and settings via Graph API.not reviewedGrowingB
Inbox ZeroSearch Gmail and Outlook, save drafts, manage email rules, and view email stats.not reviewedEstablishedA