Skip to main content
Glama
d-mato

gmail-mcp

by d-mato
OverviewSchemaSourceRelated ServersScoreDiscussionsAdmin
TypeScript
Local

gmail-mcp

npm version

MCP server for Gmail — search, read, archive, and manage your email from any MCP client.

Setup

Add to your MCP client configuration:

{
  "mcpServers": {
    "gmail": {
      "command": "npx",
      "args": ["-y", "@d-mato/gmail-mcp"]
    }
  }
}

On first launch, a browser window will open for Google account authorization. After granting access, the token is stored locally at ~/.gmail-mcp/tokens.json and you won't need to authorize again.

Related MCP server: Gmail Plugin MCP Server

Available Tools

Messages

Tool

Description

gmail_search

Search messages using Gmail query syntax (e.g. from:user@example.com, is:unread); paginate with pageToken

gmail_get_message

Get the full content of a message by ID

gmail_get_thread

Get all messages in a thread by thread ID

gmail_get_attachment

Download an attachment (inline for images/text, or save to disk)

gmail_archive

Archive a message (remove from inbox)

gmail_batch_archive

Archive multiple messages in a single API call

gmail_trash

Move a message to trash

gmail_batch_trash

Move multiple messages to trash in a single API call

gmail_untrash

Remove a message from trash

gmail_mark_read

Mark a message as read

gmail_mark_unread

Mark a message as unread

Threads

Tool

Description

gmail_archive_thread

Archive all messages in a thread (remove from inbox)

gmail_trash_thread

Move all messages in a thread to trash

gmail_untrash_thread

Remove a thread from trash

gmail_mark_thread_read

Mark all messages in a thread as read

gmail_mark_thread_unread

Mark all messages in a thread as unread

Labels

Tool

Description

gmail_list_labels

List all labels

gmail_add_label

Add a label to a message

gmail_remove_label

Remove a label from a message

gmail_create_label

Create a new label

gmail_delete_label

Delete a label

License

MIT

This server cannot be installed

RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessUnresponsive

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

Related MCP Servers