Communication · Developer Tools

Gmail MCP Server Btq logo

Gmail MCP Server Btq

david-strejc/gmail-mcp-server

This project implements a Model Context Protocol (MCP) server that allows interaction with Gmail accounts via IMAP and SMTP. It provides tools for searching emails, retrieving content, managing labels (creating, deleting, renaming, applying, removing), and sending/forwarding emails.

Install

Client configuration

{
  "mcpServers": {
    "gmail": {
      "command": "/path/to/your/project/gmail-mcp-server/.venv/bin/python",
      "args": [
        "/path/to/your/project/gmail-mcp-server/src/email_client/server.py"
      ]
    }
  }
}

Environment variables

GMAIL_EMAILGMAIL_PASSWORDGMAIL_IMAP_SERVERGMAIL_SMTP_SERVERGMAIL_SMTP_PORT
GitHub stars
2
Category
Communication, Developer Tools
Updated
Oct 6, 2026

Features

  • Email Search: Search emails by date range, keyword, or raw Gmail query string. Supports searching specific folders (inbox, sent) and limiting results. Uses Gmail's X-GM-RAW extension for efficient…

  • Email Content Retrieval: Fetch the full content (headers, body, attachments) of a specific email using its sequence ID.

  • Label Management (CRUD):

  • Batch Operations:

  • Email Sending: Send new emails (requires SMTP configuration).

  • Email Forwarding: Forward existing emails, including attachments (requires SMTP configuration).

  • Daily Email Count: Count emails received per day within a specified date range.

Tools (14)

  • search-emails

    Search emails.

  • get-email-content

    Get full email details.

  • count-daily-emails

    Count emails per day.

  • create-label

    Create a new label.

  • rename-label

    Rename an existing label.

  • delete-label

    Delete a label.

  • apply-label

    Apply a label to one email.

  • remove-label

    Remove a label from one email.

  • apply-label-batch

    Apply a label to multiple emails.

  • remove-label-batch

    Remove a label from multiple emails.

  • move-email

    Move a single email to a label.

  • move-email-batch

    Move multiple emails to a label.

  • send-email

    Send a new email.

  • forward-email

    Forward an existing email.

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
Cline logo

Cline

Desktop · Free · MIT

An AI coding assistant integrated into the IDE. Supports MCP servers for enhanced functionality.

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