Skip to main content
Glama
d-mato

gmail-mcp

by d-mato
OverviewSchemaRelated ServersScoreDiscussions
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

A
license - permissive license
-
quality - not tested
B
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
2wRelease cycle
9Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

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

Related MCP Servers

View all related MCP servers

Related MCP Connectors

  • MCP Emails

    Read, search, send, organize, draft and schedule email across your inboxes from any MCP client.

  • shipmail-mcp

    Shipmail MCP server for AI agent custom-domain email inboxes with REST API and webhooks.

  • sebastianall1977-gmail-mcp

    Manage Gmail end-to-end: search, read, send, draft, label, and organize threads. Automate workflow…

View all MCP Connectors

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/d-mato/gmail-mcp'

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