Communication · Developer Tools

MCP-email-server logo

MCP-email-server

cristip73/MCP-email-server

A Model Context Protocol (MCP) server that enables Claude Desktop App (or any other app that supports MCP) to interact with Gmail, providing capabilities for reading, searching, and sending emails through a standardized interface, and much more.

Install

npx -y @cristip73/email-mcp

Client configuration

{
  "mcpServers": {
    "email-server": {
      "command": "npx",
      "args": [
        "-y",
        "@cristip73/email-mcp"
      ],
      "env": {
        "TIME_ZONE": "<TIME_ZONE>",
        "DEFAULT_ATTACHMENTS_FOLDER": "<DEFAULT_ATTACHMENTS_FOLDER>"
      }
    }
  }
}

Environment variables

TIME_ZONEDEFAULT_ATTACHMENTS_FOLDER
GitHub stars
2
Category
Communication, Developer Tools
License
MIT
Updated
Oct 6, 2026

Features

  • Send Email: Send new emails with support for CC, BCC, and attachments

  • Read Email: Retrieve and display email content, headers, and attachments

  • Search Emails: Search emails using Gmail's query syntax with enhanced features

  • Create Drafts: Save email drafts for later editing or sending

  • List Drafts: View all saved drafts with pagination support

  • Update Drafts: Edit existing drafts with full content modification

  • Send Drafts: Convert saved drafts to sent emails

Tools (28)

  • Reply

    Reply to existing emails while maintaining thread context

  • Forward

    Forward emails to other recipients with original headers and formatting

  • subject

    Email subject (required)

  • body

    Email body content (required)

  • inReplyTo

    Message ID to reply to

  • threadId

    Thread ID to add the message to

  • messageId

    ID of the message to reply to (required)

  • additionalRecipients

    Additional recipients to include in the reply

  • excludeRecipients

    Recipients to exclude from the reply

  • from

    Specific send-as email address to use as sender (optional)

  • additionalContent

    Additional content to add before the forwarded message

  • maxResults

    Maximum number of results to return (default: 25)

  • query

    Additional Gmail search query

  • pageToken

    Token for the next page of results

  • category

    Filter by Gmail category (primary, social, promotions, updates, forums)

  • timeFilter

    Predefined time filter (today, yesterday, last24h)

  • autoFetchAll

    Automatically fetch all results (up to 100) without requiring pagination

  • labelId

    ID of the label to retrieve (required)

  • messageListVisibility

    Controls the label's visibility in the message list (show or hide)

  • labelListVisibility

    Controls the label's visibility in the label list (labelShow, labelShowIfUnread, or labelHide)

  • textColor

    Text color in hex format (e.g., #000000)

  • backgroundColor

    Background color in hex format (e.g., #ffffff)

  • draftId

    ID of the draft to retrieve (required)

  • to

    New list of recipient email addresses (required)

  • cc

    New list of CC recipients

  • bcc

    New list of BCC recipients

  • attachmentId

    ID of the attachment (like 'f_mamj3yyo1') OR the filename of the attachment (like 'document.pdf').

  • targetPath

    Filename or relative path where the attachment will be saved (will be saved inside the DEFAULT_ATTACHMENTS_FOLDER)

Details on this page are taken from the project's README. Open README

Supported clients

Clients mentioned in this server's README:

View all
Claude Desktop logo

Claude Desktop

Desktop · Freemium · Proprietary

Anthropic's official Claude AI desktop application. Supports MCP servers to extend functionality.

WindowsMacOS
Cursor logo

Cursor

Desktop · Freemium · Proprietary

The first agentic IDE. The Cursor editor truly merges how developers and AI work together, delivering a magical coding experience.

WindowsMacOSLinux

Related MCP servers

More servers
Inbox Zero AI MCP logo

Inbox Zero AI MCP

elie222/inbox-zero

7.1k

To help you spend less time in your inbox, so you can focus on what matters most.

Communication
whatsapp logo

whatsapp

lharries/whatsapp-mcp

3.6k

This is a Model Context Protocol (MCP) server for WhatsApp.

Communication
Apple MCP Server logo

Apple MCP Server

Dhravya/apple-mcp

1.5k

Apple MCP toolset is a collection of Apple native tools based on the MCP protocol, providing integration services for Messages, Notes, Contacts, Mail, Reminders, Calendar and other Apple ecosystem features.

Communication
supergateway logo

supergateway

supercorp-ai/supergateway

1.1k

Supergateway runs MCP stdio-based servers over SSE (Server-Sent Events) or WebSockets (WS) with one command. This is useful for remote access, debugging, or connecting to clients when your MCP server only supports stdio.

Communication
Line Bot MCP Server logo

Line Bot MCP Server

line/line-bot-mcp-server

338

Model Context Protocol (MCP) server implementation that integrates the LINE Messaging API to connect an AI Agent to the LINE Official Account.

Communication
MCP Send Email logo

MCP Send Email

resend/mcp-send-email

325

Connect your AI agent to the Resend platform. Send and receive emails, manage contacts, broadcasts, domains, and more, directly from any MCP client like Claude, Cursor, or Claude Code.

Communication