Skip to main content
Glama
d-mato

gmail-mcp

by d-mato
OverviewSchemaSourceRelated ServersDiscussionsAdmin
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 deployed

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

Maintenance

ActivitySlowing
ResponsivenessUnresponsive

Resources

Related MCP Connectors

Related MCP Servers

  • Gmail Plugin MCP Server

    sanchisingh01
    A
    license
    Not graded
    quality
    D
    maintenance
    An MCP server that enables Gmail integration, allowing users to manage emails (send, receive, read, trash, mark as read) directly through MCP clients like Claude Desktop.
    1
    MIT

  • multi-gmail-mcp

    joewhaley
    A
    license
    Not graded
    quality
    D
    maintenance
    An MCP server that provides read, label, and draft access to multiple Gmail accounts from a single server, never sending email.
    52 npm
    MIT