email-mcp

email-mcp is an MCP server, listed under communication. It reaches email and gmail. It needs EMAIL_MCP_KEY to authenticate. Its repository has 26 GitHub stars and is licensed under MIT; we last read it on 2026-10-22.

Connects to Gmail, Outlook, iCloud, and IMAP servers to unify email access.

MCP servers are packaged differently from each other -- some run via npx, some as a Docker image, some as a plain script you clone and run. email-mcp’s own README did not state one plainly enough for this page to quote it rather than guess, so it will not guess. The repository below states it.

31 tools documented in its README. An AI client calls these by name.

email_list_accounts

List all configured accounts with connection status

email_add_account

Add a new IMAP or iCloud account (Gmail/Outlook require setup wizard)

email_remove_account

Remove an account and its stored credentials; revokes the Google grant for Gmail, removes Outlook tokens from the local token cache, and reports the outcome

email_test_account

Test connection to an account

email_list_folders

List all folders/labels for an account

email_search

Search emails with filters. Returns compact results by default (`returnBody=false`). Set `returnBody=true` to include full email bodies

email_get

Get full email content by ID (headers, body, attachment metadata). `sourceFolder` names the folder on iCloud/IMAP when the message is not in INBOX

email_get_thread

Get an entire email thread/conversation. On iCloud/IMAP a thread is searched in one folder: INBOX, or the one named in `sourceFolder`

email_get_attachment

Download a specific attachment by ID (returns base64 data). `sourceFolder` names the folder on iCloud/IMAP when the message is not in INBOX

email_save_attachment

Download an attachment directly to disk, returning metadata only, which avoids the token cost of round-tripping large files as base64. `outputPath` is relative to a fixed downloads directory (`~/.emai

email_send

Compose and send a new email (to, cc, bcc, subject, body, attachments)

email_reply

Reply to an email in its thread. `replyAll` addresses the sender and all To/Cc recipients except your own address, each once. Optional `to`/`cc`/`bcc` overrides and `additionalRecipients`, e.g. when r

email_forward

Forward an email to new recipients (`to`, `cc`, `bcc`, optional text on top, attachments). The original's attachments are left out unless `includeOriginalAttachments: true`. `sourceFolder` names the f

email_draft_create

Save a draft without sending (attachments supported). `inReplyToEmailId` saves it as a reply inside that message's thread (`inReplyToSourceFolder` names that message's folder on iCloud/IMAP when it is

email_draft_update

Update an existing draft in place. A reply draft stays in its thread. On Gmail/Outlook the draft id is unchanged; on iCloud/generic IMAP there's no in-place update (IMAP messages are immutable), so th

email_draft_list

List all drafts

email_move

Move an email to a different folder. Supports `sourceFolder` for IMAP/iCloud

email_transfer

Move or copy emails **between accounts**, preserving the original message (sender, date, threading) via raw MIME transfer. `deleteAfter=true` trashes the source only after a confirmed import (safe cro

email_delete

Delete an email (trash or permanent). Supports `sourceFolder` for IMAP/iCloud

email_mark

Mark as read/unread, starred, or flagged. Supports `sourceFolder` for IMAP/iCloud

email_label

Add/remove labels (Gmail only)

email_folder_create

Create a new folder

email_get_labels

List all labels with counts (Gmail only)

email_get_categories

List all categories (Outlook only)

email_batch_delete

Delete multiple emails at once (up to 1000 for Gmail, batches of 20 for Outlook, UID ranges for IMAP)

email_batch_move

Move multiple emails to a folder in a single call

email_batch_mark

Mark multiple emails read/unread, starred, or flagged at once

email_batch_label

Add or remove labels on multiple emails at once (native batch call on Gmail, one by one elsewhere)

email_report_spam

Report an email as spam/junk, training the provider's own filter — the same signal the

email_batch_report_spam

Report multiple emails as spam/junk at once

email_create_block_rule

Create a standing rule that intercepts future mail matching a pattern (sender domain/address, subject, or arbitrary header content) and either deletes it or moves it. Use `headerContains` (e.g. a Repl

Read from the README; names are kept only if the README contains them.

Ranked by services in common with email-mcp, then by stars. Figures are from each repository when we last read it.

What does email-mcp do?

Connects to Gmail, Outlook, iCloud, and IMAP servers to unify email access.

How do I install email-mcp?

Its README did not state an install command plainly enough for us to quote one, so we do not guess. The repository has the instructions: https://github.com/marlinjai/email-mcp

What does email-mcp connect to, and what does it need?

It reaches email and gmail. The credentials we found in its source are EMAIL_MCP_KEY.

Is email-mcp official and is it maintained?

We found nothing naming it as a vendor’s official server. Its repository has 26 GitHub stars and its state in our directory is listed. Its last commit we recorded was on 2026-10-20.

What licence does email-mcp use?

The repository declares the MIT licence.

• line-bot-mcp-server789 stars
• graphlit-mcp-server377 stars
• mcp-email-server368 stars
• telegram-mcp349 stars
• human-in-the-loop230 stars
• google-workspace-mcp192 stars

All communication entries →

• Introduction to Model Context Protocol (Claude Academy)
• The Hugging Face MCP course
• Build an AI agent: a path with skills and MCP servers to practise on