Email MCP Server by codefuturist: Setup for Claude, Cursor and More

• Lists your folders with unread counts

  Shows every folder in an account with how many messages are unread and which is Inbox, Sent or Trash.

  Try: “Show my folders and how many unread each has.”

  Read · list_mailboxes

• Lists recent emails in a folder

  Pages through a folder with filters and shows read, flagged, replied and attachment marks. Newsletters and automated mail are tagged.

  Try: “Show my 20 newest unread emails in the Inbox.”

  Read · list_emails

• Reads one full email

  Fetches the whole message without marking it as read. You can ask for plain text, text without quoted replies, or the full form.

  Try: “Open the latest email from Sarah and summarise it.”

  Read · get_email

• Reads up to 20 emails at once

  Fetches several full messages in one call, up to 20. Useful for triage and summaries.

  Try: “Read my 10 newest unread emails and tell me which need a reply.”

  Read · get_emails

• Checks if an email is read, flagged or labelled

  Returns the read, flag and label state of one message without its body. Cheaper than opening the email.

  Try: “Is the invoice email from Monday still unread?”

  Read · get_email_status

• Searches mail by keyword or filter

  Searches subject, sender and body, and attachment filenames when the local mirror is on. With no keyword it works as a plain filter.

  Try: “Find emails about the Q3 report from last month.”

  Read · search_emails

• Reads a whole conversation

  Rebuilds a thread from its reply headers and returns all related messages without marking them read.

  Try: “Show the full thread about the contract renewal.”

  Read · get_thread

• Gets an attachment from an email

  Downloads one attachment by filename or part id and returns it as base64. It can also save the file to a download folder if you set one.

  Try: “Download the PDF attached to the latest invoice email.”

  Files · download_attachment

• Lists people you email most

  Builds a list of unique contacts from recent email headers, sorted by how often they appear.

  Try: “Who do I email most often this month?”

  Read · extract_contacts

• Shows mailbox volume and top senders

  Reports email volume, top senders, daily trends and read and flagged counts for a folder.

  Try: “Who sends me the most email and on which days?”

  Read · get_email_stats

• Sends a new email

  Sends a new message with plain text or HTML, CC and BCC. A rate limit of 10 sends a minute applies by default.

  Try: “Email tom@example.com that the meeting moves to 3pm.”

  Write · send_email

• Replies to an email

  Sends a reply with correct threading and quotes the original by default. It sends right away.

  Try: “Reply to Anna and say I can do Thursday.”

  Write · reply_email

• Forwards an email

  Forwards a message to new recipients with your note on top. Attachments are re-attached unless you turn that off.

  Try: “Forward the flight confirmation to my assistant.”

  Write · forward_email

• Saves an email as a draft

  Stores a draft in your Drafts folder so you can finish it later.

  Try: “Draft a reply to the vendor but do not send it.”

  Write · save_draft

• Sends a saved draft

  Sends a draft from your Drafts folder and then removes it from there.

  Try: “Send the draft I saved to the vendor.”

  Delete · send_draft

• Sends an email at a later time

  Queues an email on your machine and sends it when the time comes. The server must be running then.

  Try: “Schedule this email to send tomorrow at 9am.”

  Write · schedule_email

• Lists emails waiting to be sent

  Shows scheduled emails that are pending, already sent, or both.

  Try: “What emails do I have scheduled?”

  Read · list_scheduled

• Cancels a scheduled email

  Removes a queued email and deletes its draft.

  Try: “Cancel the scheduled email to the vendor.”

  Delete · cancel_scheduled

• Moves an email to another folder

  Moves a message to a folder you name. The source must be a real folder, not a virtual one.

  Try: “Move the receipts from today into the Receipts folder.”

  Write · move_email

• Deletes an email

  Moves a message to Trash by default. With the permanent option it deletes it for good.

  Try: “Delete the spam email from this morning.”

  Delete · delete_email

• Marks mail read, unread or flagged

  Changes the read and flag state of a message. Repeating it does nothing extra.

  Try: “Mark all emails from the bank as read.”

  Write · mark_email

• Changes up to 100 emails at once

  Marks, flags, moves or deletes a list of messages in one call, up to 100. Returns how many worked.

  Try: “Move these 40 newsletters to the Archive folder.”

  Delete · bulk_action

• Creates a folder

  Makes a new mailbox. Use a slash for nested folders like Work/Projects.

  Try: “Create a folder called Work/Invoices.”

  Write · create_mailbox

• Renames a folder

  Changes the name of an existing mailbox.

  Try: “Rename the folder Old to Archive 2023.”

  Write · rename_mailbox

• Deletes a folder and its mail

  Permanently deletes a folder and every message in it. The tool itself warns this cannot be undone.

  Try: “Delete the empty folder Temp.”

  Delete · delete_mailbox

• Lists labels

  Shows the labels for an account. It handles Gmail labels, ProtonMail label folders and plain IMAP keywords.

  Try: “What labels do I have?”

  Read · list_labels

• Puts a label on an email

  Adds a label to a message. On ProtonMail it copies the mail into the label folder.

  Try: “Label the contract email as Legal.”

  Write · add_label

• Takes a label off an email

  Removes a label from a message. On ProtonMail it removes the copy from the label folder.

  Try: “Remove the Urgent label from this email.”

  Write · remove_label

• Creates a label

  Makes a new label. For plain IMAP it does nothing because labels appear on first use.

  Try: “Create a label called Follow-up.”

  Write · create_label

• Deletes a label

  Deletes a label folder on ProtonMail. On plain IMAP it cannot delete server-wide and points you to remove it per email.

  Try: “Delete the label Old Projects.”

  Delete · delete_label

• Lists email templates

  Shows the templates stored as files in your config folder.

  Try: “What email templates do I have?”

  Files · list_templates

• Fills in a template

  Fills a template with your values. You can preview it, save it as a draft or send it right away.

  Try: “Use the follow-up template for Acme and preview it.”

  Write · apply_template

• Finds a sign-in code in your mail

  Looks for the newest one-time code or magic link in recent mail and can wait up to 45 seconds for it to arrive.

  Try: “Get the verification code that was just emailed to me.”

  Read · get_verification_code

• Changes code-catching settings

  Updates the verification settings while running, and can save them to your config file with a backup.

  Try: “Turn on automatic catching of verification codes.”

  Write · configure_verification

• Lists AI triage presets

  Shows the built-in triage presets with a description and suggested labels each.

  Try: “What triage presets are available?”

  Read · list_presets

• Shows AI triage settings

  Returns the current preset, rules and custom instructions for AI triage.

  Try: “Show my current triage rules.”

  Read · get_hooks_config

• Changes alert settings

  Updates notification settings on the fly, and can save them to your config file.

  Try: “Turn off alert sounds.”

  Write · configure_alerts

• Reads an invite inside an email

  Pulls the event details out of a calendar invite in a message: time, place, attendees and status.

  Try: “What are the details of the meeting invite in this email?”

  Read · extract_calendar

• Spots events and to-dos in an email

  Checks whether a message holds an event or a reminder-worthy task so the assistant can decide what to create.

  Try: “Does this email contain anything I should put in my calendar?”

  Read · analyze_email_for_scheduling

• Lists your local calendars

  Shows the calendars in Calendar.app on macOS or the default one on Linux.

  Try: “Which calendars do I have?”

  Read · list_calendars

• Searches your local calendar

  Lists calendar events by title, date range or calendar so you can avoid duplicates.

  Try: “What is on my calendar next week?”

  Read · list_events

• Adds an email event to your calendar

  Creates a calendar event from a message, with meeting link, dial-in and attendees. On macOS a confirmation dialog appears first.

  Try: “Add the meeting from this email to my calendar.”

  Runs code · add_to_calendar

• Lists macOS Reminders

  Shows reminders from Reminders.app, by default only the open ones.

  Try: “What reminders do I have open?”

  Read · list_reminders

• Creates a reminder from an email

  Adds a reminder in macOS Reminders with a link back to the email. A confirmation dialog appears first.

  Try: “Remind me to answer this email on Friday.”

  Runs code · create_reminder

• Used by the assistant behind the scenes

  Shows which email accounts are set up

  Lists the email accounts in your config. The assistant calls it first to learn the account names.

  Try: “Which email accounts do you have access to?”

  Read · list_accounts

• Finds the real folder of an email

  Finds the actual folder a message sits in when it was found in a virtual one like All Mail. Needed before moving or deleting it.

  Try: “Which folder is this email really in?”

  Read · find_email_folder

• Checks connections and cache

  Tests the connection, quota and features of each account and reports local cache size and hit rate. Use it to find setup problems.

  Try: “Is my email connection healthy?”

  Read · check_health

• Checks code-to-clipboard setup

  Tests whether caught verification codes can be copied to your clipboard. With the test option it writes a harmless test value.

  Try: “Is the clipboard setup for codes working?”

  Write · check_clipboard_setup

• Shows live mail watcher status

  Reports the state of the connections that watch your inbox for new mail.

  Try: “Is the inbox watcher running?”

  Read · get_watcher_status

• Checks desktop notifications

  Tests whether your system can show desktop notifications and gives setup steps.

  Try: “Can this server show desktop notifications?”

  Read · check_notification_setup

• Shows a test notification

  Pops up a desktop notification to confirm permissions work.

  Try: “Send me a test notification.”

  Runs code · test_notification

• Checks calendar access

  Reports whether the local calendar app can be reached and how to grant access on macOS.

  Try: “Can you access my calendar?”

  Read · check_calendar_permissions

Watch out for

• It can send and permanently delete email

  send_email, reply_email and forward_email send at once, and delete_email, delete_mailbox and bulk_action can remove mail for good. Set MCP_EMAIL_READ_ONLY=true unless you need these. github.com

• Your mail password can sit in plain text

  The password field takes a literal app password, a keychain: reference (macOS Keychain or Linux libsecret) or an env: reference. A literal value is stored in ~/.config/email-mcp/config.toml, which the README says is written with 0600 permissions. If you pass MCP_EMAIL_PASSWORD in your app's MCP config instead, the password sits in that file. Prefer the keychain option. github.com

• Read-only mode still allows some writes

  Read-only removes the mailbox-write tools only. add_to_calendar, create_reminder, configure_verification and configure_alerts stay available. github.com

• It keeps a local copy of your mail

  Reads are served from a local SQLite mirror of your mail and attachments on your disk. Protect the disk and delete the cache if you stop using it. github.com

• The optional HTTP mode needs a token

  Streamable HTTP binds to 127.0.0.1 by default. If you bind it to another address, set a token with the --token option. github.com

Security advisories