Skip to main content
Glama
hjerkic

gmail-mcp-server

by hjerkic

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
TOKEN_ENCRYPTION_KEYYesKey used to encrypt token storage. Generate with: python -c "from cryptography.fernet import Fernet; print(Fernet.generate_key().decode())"

Capabilities

Features and capabilities supported by this server

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

Tools

Functions exposed to the LLM to take actions

NameDescription
gmail_searchA

Search messages using Gmail's search syntax (e.g. "from:boss is:unread").

Returns compact metadata (id, thread_id, from, subject, date, snippet, labels) — no message bodies. Use gmail_read_message for a full body.

gmail_read_messageB

Fetch one message in full, including its plain-text body.

gmail_list_recentA

Fast, compact fetch of recent inbox messages for periodic triage.

Intentionally returns metadata + snippet only (no bodies) so it's cheap to call on a schedule. This tool does not decide what's "urgent" — it hands back enough signal (subject, sender, snippet, labels like IMPORTANT/STARRED/UNREAD) for the caller to make that judgment.

gmail_create_draftA

Create a draft email. This never sends anything.

Pass thread_id to draft a reply within an existing thread (the draft will pick up proper In-Reply-To/References headers automatically).

gmail_send_draftA

Send a previously created draft. This is a real, irreversible send.

There is no tool to send arbitrary text directly — a draft must be created first via gmail_create_draft.

gmail_apply_labelA

Attach a custom label to a message (creating it first if needed).

Only user-created labels can be applied through this tool — system labels (TRASH, SPAM, INBOX, UNREAD, IMPORTANT, ...) are rejected, so this tool cannot be used to trash, spam, or archive a message. Returns the label id that was applied.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/hjerkic/gmail-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server