Gmail Attachment MCP Server

Name: Gmail Attachment MCP Server
Author: gnmahanth

@gnmahanth

代码仓库

关于 Gmail Attachment MCP Server

mcp server for downloading attachments from gmail using imap

基本信息

分类

沟通协作

许可证

MIT license

运行时

python

传输方式

stdio

发布者

gnmahanth

配置

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

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

工具

未检测到工具

工具是从 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

FAQ from Gmail Attachment MCP Server

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 服务器

PhonePi MCP: Turn your phone into a toolbox for AI assistants using Model Context Protocol

priyankark

PhonePi MCP enables seamless integration between desktop AI tools and your smartphone, providing 23+ direct actions including SMS messaging, phone calls, contact management, snippet creation and search, clipboard sharing, notifications, battery status checks, and remote device co