Gmail Attachment MCP Server

@gnmahanth

代码仓库

基本信息

分类

沟通协作

许可证

MIT license

传输方式

stdio

作者

gnmahanth

关于 Gmail Attachment MCP Server

mcp server for downloading attachments from gmail using imap

Gmail Attachment MCP Server 配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "gmail-attachment-mcp-server": {
      "command": "uv",
      "args": [
        "sync"
      ]
    }
  }
}

Gmail Attachment MCP Server 工具

工具列表暂未提供

当前收录暂时没有可展示的工具列表，不代表服务没有工具。请查阅项目文档了解支持的能力。

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is Gmail Attachment MCP Server?

Gmail Attachment MCP Server is a FastMCP server that downloads attachments from Gmail messages using the Message Control Protocol (MCP). It connects to Gmail via IMAP over SSL and requires a Gmail account with IMAP enabled and an App Password if 2‑Step Verification is active. It is intended for developers or automation workflows that need to programmatically retrieve email attachments.

How to use Gmail Attachment MCP Server?

Set environment variables GMAIL_USERNAME, GMAIL_PASSWORD, and optionally GMAIL_IMAP_SERVER (defaults to imap.gmail.com). Install dependencies with uv sync, then start the server with python server.py or mcp run server.py. Invoke the download_attachments_tool() with a hexadecimal message ID and an optional download folder (defaults to ./attachments).

Key features of Gmail Attachment MCP Server

Download Gmail attachments using a message ID
Secure connection via IMAP over SSL
Configuration through environment variables
Simple API exposed as an MCP tool
Works with MCP Inspector and Goose

Use cases of Gmail Attachment MCP Server

Automatically save attachments from specific emails in a workflow
Retrieve invoices or documents from Gmail programmatically
Integrate email attachment downloading into an MCP‑based toolchain

常见问题

What are the prerequisites?

Python 3.7 or higher, `uv` installed, a Gmail account with IMAP enabled, and an App Password if 2‑Step Verification is enabled.

How do I configure Gmail credentials?

Set `GMAIL_USERNAME` (your full Gmail address) and `GMAIL_PASSWORD` (your App Password). The IMAP server defaults to `imap.gmail.com` and can be overridden with `GMAIL_IMAP_SERVER`.

What transport does the server use?

The server communicates over stdio, as shown in the MCP Inspector and Goose configuration examples.

What is the default download folder?

Attachments are saved to `./attachments` unless the `download_folder` parameter is specified.

Can I use my regular Gmail password?

No. For Gmail accounts with 2‑Step Verification, you must generate and use an App Password. See Google’s documentation for instructions.

沟通协作分类下的更多 MCP 服务器

LinkedIn MCP Server: DMs, Inbox & Network for Claude, ChatGPT, Cursor

TalkToHumans

LinkedIn MCP server for Claude, ChatGPT, Cursor & Codex. Read LinkedIn DMs, search your network, enrich profiles and draft messages you review before sending.

Faxify MCP

Const Agility, LLC

Send, receive and track real faxes in the US and Canada from Claude, ChatGPT or Cursor.

Faivelo Email

Benjamin Brookarsh

Business email on your own domain for AI agents. Read, search and send mail, manage mailboxes and aliases, and set up DNS automatically, with unlimited mailboxes on one flat plan.

Instant Expert

Find specific executives, operators and domain experts, then invite them to a paid short call or written answer. You pay only if they book or answer.

Summer

Telehealth support for Claude, Codex and Cursor. Investigate stuck orders and billing issues, review case evidence, connect your tools and prepare next steps with Summer.