amazing-gmail-mcp
by trustxai
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| GMAIL_ACCOUNT | Yes | Required. The one mailbox this process serves. The refresh token's profile must match this email address, ignoring case. | |
| GMAIL_CLIENT_ID | No | The OAuth client ID, used together with GMAIL_CLIENT_SECRET instead of GMAIL_CLIENT_SECRET_FILE. | |
| GMAIL_SCOPE_LABEL | No | Optional 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_QUERY | No | Optional 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_SECRET | No | The OAuth client secret, used together with GMAIL_CLIENT_ID instead of GMAIL_CLIENT_SECRET_FILE. Never logged or echoed. | |
| GMAIL_REFRESH_TOKEN | Yes | Required. The gmail.readonly refresh token from amazing-gmail-mcp-login. Must contain no whitespace and is never logged or echoed. | |
| GMAIL_ATTACHMENT_DIR | No | Directory where gmail_get_attachment saves files, under one directory per message id; ~ is expanded. | ~/Downloads/gmail-mcp |
| GMAIL_BODY_MAX_CHARS | No | Body characters per call: one message body, or a thread page's total body characters. Allowed range: 100 to 150000. | 20000 |
| GMAIL_CLIENT_SECRET_FILE | No | Path 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_BYTES | No | Largest 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
| Name | Description |
|---|---|
No tools | |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
This server cannot be deployed
Maintenance
ActivityMaintained
ResponsivenessNo recent community issues