Skip to main content
Glama
amazing-gmail-mcp
by trustxai

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
GMAIL_ACCOUNTYesRequired. The one mailbox this process serves. The refresh token's profile must match this email address, ignoring case.
GMAIL_CLIENT_IDNoThe OAuth client ID, used together with GMAIL_CLIENT_SECRET instead of GMAIL_CLIENT_SECRET_FILE.
GMAIL_SCOPE_LABELNoOptional label scope: a label id, exact name, or case-insensitively unique name. Every search and every fetch by id is limited to this label.
GMAIL_SCOPE_QUERYNoOptional Gmail query scope, ANDed with every search as (<scope>) (<query>). Maximum 1,500 characters and 6,000 characters once percent-encoded; must be valid UTF-8 and must not break out of its parentheses.
GMAIL_CLIENT_SECRETNoThe OAuth client secret, used together with GMAIL_CLIENT_ID instead of GMAIL_CLIENT_SECRET_FILE. Never logged or echoed.
GMAIL_REFRESH_TOKENYesRequired. The gmail.readonly refresh token from amazing-gmail-mcp-login. Must contain no whitespace and is never logged or echoed.
GMAIL_ATTACHMENT_DIRNoDirectory where gmail_get_attachment saves files, under one directory per message id; ~ is expanded.~/Downloads/gmail-mcp
GMAIL_BODY_MAX_CHARSNoBody characters per call: one message body, or a thread page's total body characters. Allowed range: 100 to 150000.20000
GMAIL_CLIENT_SECRET_FILENoPath to the Desktop OAuth client JSON (with an installed key) that minted the token; ~ is expanded. Set this instead of GMAIL_CLIENT_ID + GMAIL_CLIENT_SECRET; both forms at once are refused.
GMAIL_ATTACHMENT_MAX_BYTESNoLargest attachment to save, in bytes. Allowed range: 1 to 1073741824. Larger or unknown-size attachments are refused before downloading.26214400

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

Server capabilities have not been inspected yet.

Tools

Functions exposed to the LLM to take actions

NameDescription

No tools

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources