Gmail MCP Server

What it does

Connects an AI agent to the Gmail API, enabling complete management of a user's mailbox. It allows the AI to not only send and read emails but also handle complex Gmail workflows like managing labels, archiving, and drafting.

Tools

• send_email: Send new messages with CC/BCC support.
• reply_all_email: Smart reply to all participants in a thread.
• forward_email: Forward emails with original headers.
• get_recent_emails: Retrieve emails with time and category filters.
• read_email: Extract full content of a specific message.
• search_emails: Advanced search using Gmail query syntax.
• create_draft/update_draft/send_draft: Full lifecycle management of email drafts.
• modify_labels: Add or remove labels from messages.
• save_attachment: Download email attachments to a local folder.

Installation

Add the following to your claude_desktop_config.json:

{
  "mcpServers": {
    "email-server": {
      "command": "npx",
      "args": [
        "-y",
        "@cristip73/email-mcp"
      ],
      "env": {
          "TIME_ZONE": "GMT+0",
          "DEFAULT_ATTACHMENTS_FOLDER": "/path/to/attachments"
      }
    }
  }
}

Supported hosts

• Claude Desktop
• Claude Code