Skip to main content
Glama
savestidolajr

gmail-attachments-mcp

by savestidolajr
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Hybrid

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
MCP_AUTH_TOKENNoHosted mode only: bearer token protecting the /mcp endpoint. Must be at least 32 characters or the server rejects every request. Usually set by scripts/vercel-setup.sh.
GMAIL_ATT_CLIENT_IDNoHosted mode only: OAuth client ID, used instead of token.json.
GMAIL_ATT_CONFIG_DIRNoWhere the Gmail OAuth credentials/token live (defaults to ~/.config/gmail-attachments-mcp/).
GMAIL_ATT_CLIENT_FILENoPath to the OAuth client JSON (credentials.json).
GMAIL_ATT_DOWNLOAD_DIRNoDefault download folder for attachments (defaults to ~/Downloads/gmail-attachments).
GMAIL_ATT_CLIENT_SECRETNoHosted mode only: OAuth client secret, used instead of token.json.
GMAIL_ATT_REFRESH_TOKENNoHosted mode only: OAuth refresh token, used instead of token.json.

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
list_attachmentsA

List attachments on a Gmail message (name, type, size in bytes).

message_id is the Gmail message id, e.g. from the Gmail connector's search_threads.
download_attachmentA

Save one attachment to disk and return the file path.

filename: exact name from list_attachments. index: pick among duplicate names.
dest_dir: folder to save into (default ~/Downloads/gmail-attachments).
Existing files are never overwritten; a numeric suffix is added.
read_attachment_textA

Return the text of an attachment without saving it.

Supports PDF, docx, xlsx, pptx, and text files (txt, csv, json, xml, html, md).
Other types (images, zip, doc, xls, ppt): use download_attachment (local server only).

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Deploy Server
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

A4.2/5.0

Scored across 3 tools

Disambiguation5/5

The three tools have clearly distinct purposes: listing attachments, downloading to disk, and reading text without saving. Descriptions explicitly clarify when to use each, with no overlap.

Naming Consistency5/5

All tools follow a consistent snake_case verb_noun pattern (list_attachments, download_attachment, read_attachment_text). The slight extra noun in the third tool is still clear and predictable.

Tool Count5/5

Three tools are well-scoped for a focused attachment server, covering the core operations of listing, downloading, and reading. No unnecessary tools, and the count feels just right.

Completeness4/5

The surface covers listing, downloading, and text reading of attachments, which are the primary retrieval workflows. Minor gaps like batch operations or attachment deletion/upload are not addressed, but likely outside the server's intended scope.

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources