# Mail-MCP (npm · @rixtay/mail-mcp)

Personal Outlook.com / Hotmail inbox: read, search, file, delete, unsubscribe via Microsoft Graph.

- Trust score: 79/100 (medium)
- Change this week: +7
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-10-16

## Components

- npm · `@rixtay/mail-mcp`: 79/100 (this document), [markdown](https://verifymcp.io/servers/rixtayz-mail-mcp/rixtay-mail-mcp.md), [page](https://verifymcp.io/servers/rixtayz-mail-mcp/rixtay-mail-mcp)

## Channel facts

- Registry: `npm`
- Package: `@rixtay/mail-mcp`
- Version: `0.1.2`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-10-16.

- **Supply Chain Security**: 99/100
  - No malware found by supply-chain analysis.
  - No known CVEs affecting this package version or its production dependencies.
  - No install/post-install scripts declared.
  - 12 of 46 dependencies flagged as unhealthy.
- **Provenance & Transparency**: 48/100
  - Source repository is publicly reachable at the declared URL.
  - Provenance check failed: no build-provenance attestation is published.
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 14 days ago).
  - Publishes a security disclosure policy (SECURITY.md).
- **Schema Quality & AI Usability**: 82/100
  - AI-judged instruction clarity (excellent).
  - Context-footprint check failed: tool/resource definitions use about 1083 tokens (~120/item across 9 items; 9 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 50/100
  - Stability observed for 15 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
  - Structured output schemas are declared (100% of tools); any adoption earns full credit.
- **Tool Safety**: 100/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - All 1 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation.
  - An AI judge read all 9 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 100/100
  - Implements a current MCP spec version (2026-07-28).

## Install

### How do I install the Mail-MCP server?

Mail-MCP runs locally as an npm package, launched with npx -y @rixtay/mail-mcp. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

### Claude

```bash
claude mcp add rixtayz-mail-mcp -- npx -y @rixtay/mail-mcp
```

### Cursor

```json
{
  "mcpServers": {
    "rixtayz-mail-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@rixtay/mail-mcp"
      ]
    }
  }
}
```

### VS Code

```json
{
  "servers": {
    "rixtayz-mail-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@rixtay/mail-mcp"
      ]
    }
  }
}
```

### Codex

```bash
codex mcp add rixtayz-mail-mcp -- npx -y @rixtay/mail-mcp
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "rixtayz-mail-mcp": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "@rixtay/mail-mcp"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add rixtayz-mail-mcp --command npx --arg -y --arg @rixtay/mail-mcp
```

### Hermes

```yaml
mcp_servers:
  rixtayz-mail-mcp:
    command: "npx"
    args: ["-y", "@rixtay/mail-mcp"]
```

### Netclaw

```json
{
  "McpServers": {
    "rixtayz-mail-mcp": {
      "Transport": "stdio",
      "Command": "npx",
      "Arguments": [
        "-y",
        "@rixtay/mail-mcp"
      ]
    }
  }
}
```

### Vellum

```bash
assistant mcp add rixtayz-mail-mcp -t stdio -c npx -a -y @rixtay/mail-mcp
```

### Other

```json
{
  "mcpServers": {
    "rixtayz-mail-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@rixtay/mail-mcp"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-10-15 (score 79, +1)

No change was recorded against any check on this day. Stability & Change Management went from 43 to 47. That category is still filling its 30-day observation window: 13 days of observed history at the previous scan, 14 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-10-13 (score 78, +6)

- [functional improvement] Stability: unverified → 0.40

### 2026-10-02 (score 72, +15)

- [security improvement] Malware scan: unverified → pass

### 2026-10-01 (score 57)

First indexed and scored.

## MCP tools (9)

### `mail_list_folders` (~79 tokens)

List folders

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.

Output parameters:

- `folders` (array)

### `mail_create_folder` (~98 tokens)

Create 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" }.

Input parameters:

- `name` (string, required): Name of the folder to create
- `parent` (string): Parent folder (name, path or id). Root if omitted.

Output parameters:

- `created` (boolean)
- `folder` (object)

### `mail_search` (~240 tokens)

Search messages

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.

Input parameters:

- `cursor` (string): Page cursor returned by a previous call
- `folder` (string): Folder (name, path, well-known name or id). Default: inbox
- `from` (string): Exact sender address, e.g. news@example.com
- `limit` (integer): Results per page (max 100)
- `query` (string): Full-text search (simple KQL). Exclusive with from/since/until/unreadOnly.
- `since` (string): Received on or after this date (ISO)
- `unreadOnly` (boolean): Only unread messages
- `until` (string): Received on or before this date (ISO)

Output parameters:

- `count` (number)
- `items` (array)
- `nextCursor` (string)

### `mail_get_message` (~76 tokens)

Read a message

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.

Input parameters:

- `id` (string, required): Message id (from mail_search or mail_senders_summary)

Output parameters:

- `body` (string)
- `hasAttachments` (boolean)
- `message` (object)
- `to` (array)
- `truncated` (boolean)
- `unsubscribe` (object)
- `webLink` (string)

### `mail_senders_summary` (~134 tokens)

Summary by sender

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).

Input parameters:

- `folder` (string): Folder to analyse. Default: inbox
- `since` (string): Only count messages received since this date
- `top` (integer): Number of senders to return (max 200)

Output parameters:

- `scanned` (number)
- `senders` (array)
- `totalSenders` (number)

### `mail_move` (~96 tokens)

Move 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.

Input parameters:

- `folder` (string, required): Destination folder
- `ids` (array, required): Message ids (1 to 500)

Output parameters:

- `failed` (array)
- `moved` (array)
- `succeeded` (number)

### `mail_delete` (~100 tokens)

Delete messages

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.

Input parameters:

- `ids` (array, required): Message ids (1 to 500)
- `permanent` (boolean): true = permanent deletion (irreversible). Default: Deleted Items.

Output parameters:

- `failed` (array)
- `moved` (array)
- `succeeded` (number)

### `mail_bulk_by_sender` (~140 tokens)

Bulk action by sender

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`.

Input parameters:

- `action` (string, required): move = move to targetFolder; delete = delete
- `dryRun` (boolean): true = count only, change nothing
- `folder` (string): Source folder. Default: inbox
- `from` (string, required): Exact sender address
- `permanent` (boolean): With action = delete: permanent deletion
- `targetFolder` (string): Required when action = move

Output parameters:

- `dryRun` (boolean)
- `failed` (array)
- `matched` (number)
- `succeeded` (number)

### `mail_unsubscribe` (~120 tokens)

Unsubscribe

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.

Input parameters:

- `id` (string, required): Id of a representative message of the newsletter

Output parameters:

- `detail` (string)
- `from` (string)
- `mailto` (string)
- `method` (string)
- `ok` (boolean)
- `subject` (string)
- `url` (string)

## Diagnostics

Captured diagnostic sections: Provenance, Dependencies. The full working is on the page: https://verifymcp.io/servers/rixtayz-mail-mcp/rixtay-mail-mcp#diagnostics

## Score history

- 2026-10-16: 79
- 2026-10-15: 79
- 2026-10-14: 78
- 2026-10-13: 78
- 2026-10-12: 72
- 2026-10-11: 72
- 2026-10-04: 72
- 2026-10-03: 72
- 2026-10-02: 72
- 2026-10-01: 57

## Common questions

### What is the Mail-MCP server?

Mail-MCP is listed in the public MCP registry as io.github.Rixtayz/mail-mcp. Personal Outlook.com / Hotmail inbox: read, search, file, delete, unsubscribe via Microsoft Graph. This page covers its npm package (@rixtay/mail-mcp).

### Is the Mail-MCP server safe to use?

Mail-MCP scores 79 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 16 October 2026. It declares no install or post-install scripts. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the Mail-MCP server expose?

Mail-MCP exposes 9 tools: mail_list_folders, mail_create_folder, mail_search, mail_get_message, mail_senders_summary, and 4 more. Their descriptions and schemas cost roughly 1,083 tokens of context every time the server is loaded.

### Is the Mail-MCP server still maintained?

Mail-MCP is still listed as active in the MCP registry. We last reached this channel on 16 October 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

### What licence is the Mail-MCP server under?

Mail-MCP declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.

## Links

- npm package: https://www.npmjs.com/package/@rixtay/mail-mcp
- Socket report: https://socket.dev/npm/package/@rixtay/mail-mcp
- Repository: https://github.com/Rixtayz/Mail-MCP
- Changelog RSS feed: https://verifymcp.io/servers/rixtayz-mail-mcp/rixtay-mail-mcp.xml
- Changelog JSON feed: https://verifymcp.io/servers/rixtayz-mail-mcp/rixtay-mail-mcp.json
- HTML version of this page: https://verifymcp.io/servers/rixtayz-mail-mcp/rixtay-mail-mcp