MCPEmails

Install

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

npx agentmarket install connector/mcpemails-com-emails

About

Use cases: email

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 and install config. Checked Oct 25, 2026.

Tools

5 read · 11 write · 4 delete

Secrets

1 (API keys, tokens or passwords)

Install scripts

None found

Runs as

Node.js package

Tools (20)

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

• approval_decideReject a pending send

  Reject a send that is waiting for human approval, so it is never delivered. `decision` accepts only "reject". Approving is deliberately not available over MCP — it requires a signed-in browser session with an owner or admin role, at the review_url of the approval.

• approval_reviewReview a pending sendread-only

  Fetch the full contents of a send that is waiting for human approval, including its body, so it can be shown in the review card. Read-only. Approving is not possible from here: it requires the signed-in review page linked as review_url.

• approval_scheduleSchedule a pending send

  Set the delivery time of a send that is waiting for human approval. Nothing is queued until it is approved; this only decides when an approved message goes out. send_at must be in the future.

• approval_updateEdit a pending send

  Change the subject or body of a send that is waiting for human approval. The message still has to be approved afterwards, and the reviewer sees the edited version. Subject can only be set on operations that carry one (email_send, schedule_create).

• bulk_cancelCancel a previewed bulk operation

  Decline a previewed bulk delete or move, so it can never run. Takes only the plan_id. Nothing in the mailbox changes. A preview would also expire on its own after 15 minutes; cancelling records the decision instead of leaving it implicit.

• bulk_executeRun a previewed bulk operationcan change or delete data

  Run a bulk delete or move that was previewed as a plan. Takes only the plan_id: which messages are affected was decided and frozen when the preview was created, and cannot be changed here. A plan runs at most once and expires 15 minutes after it is created.

• contact_search

  Find people the user has corresponded with, by name or address.

• draft_editor_hideHide the draft editor cardcan change or delete data

  Hide the in-chat draft editor card, or show it again, when the user asks for that, either for one inbox or for the whole workspace. This is a display preference only: drafts, sending and every other tool are completely unaffected, and the same draft results keep coming back as plain text. Pass hidden:false to turn it back on, which works at either scope even while the card is hidden. Hiding or showing it for the WHOLE workspace changes it for every member, so that scope needs a workspace owner or admin; one inbox needs no extra role.

• draft_editor_saveSave an edited draft

  Save the fields a person edited in the draft editor. Every field is optional and an omitted one keeps its stored value. No signature is applied, unlike the draft tool's 'update' when it is given a body: the text being saved is the text the person was shown, which already carries one if the inbox has one. Nothing is sent. On IMAP the save returns a NEW draft_id and the old one stops resolving. On IMAP and Gmail the save rebuilds the message from its text, so a draft with attachments, inline images other than its own signature images, or other extra parts is refused and left unchanged. A save ag…

• draft_list

  Saved drafts of one inbox (subject and recipients, no bodies).

• draft_readRead one draft in fullread-only

  Get the current text of one unsent draft, for example before revising a draft the user edited in the draft editor card. Returns recipients, subject, body_text and attachment names. Read-only: nothing is written and nothing is sent. Needs the 'read:email' scope as well as 'manage:drafts'. The user can edit, save and send a draft in the draft editor card, and you may not be told, so read it again before stating its current subject, recipients or whether it was sent: a sent draft answers that it was already sent. Where the card is on, the host shows a one-line summary for this read rather than a …

• edit_draft

  Change the current draft: its body, its recipients (to, cc) or its subject. Give only what changes. A new body must be the COMPLETE text; the user sees the changes highlighted. Only when a current draft exists.

• email_delete

  Move messages to Trash (recoverable). delete: one message_id. delete_batch: message_ids. Permanent deletion is not available.

• email_organize

  Change mail in one inbox, by message id. move / move_batch: into destination_folder_id (a folder id from folder_list). archive: out of the Inbox (message_id, or message_ids for several). flag: flag_action read | unread | flag (star) | unflag on message_ids. The user can undo all of these.

• email_read

  Read mail in one inbox. list: recent messages of a folder (previews). search: filters, ANDed. read: one full plain-text body. read_batch: several bodies at once (shorter window). list and search return one page: has_more with next_offset means there is more.

Compare and alternatives

Featured in

• Best MCP servers for Gmail

Signals

Stars

13

Forks

2

Open issues

0

Last commit

Oct 23, 2026 (5 days ago)

Last release

Oct 20, 2026 (8 days ago)

From GitHub (fetched Oct 24, 2026).

Details

Registry name

com.mcpemails/emails

Version

1.0.8

Auth

Auth not stated, API key

Packages

npm mcpemails

License

AGPL-3.0

Repository

github.com/Albretsen/MCPEmails

Website

mcpemails.com

First seen

Oct 24, 2026

Last checked

Oct 24, 2026

Source

Official MCP Registrygithub-graphql