gmail-mcp

d-mato/gmail-mcp

0 starsCommunity

Install to Claude Code

This server doesn't publish a one-line install command. Follow the setup in the source repository.

Summary

MCP server for Gmail that enables searching, reading, archiving, and managing email from any MCP client.

README.md

gmail-mcp

![npm version](https://www.npmjs.com/package/@d-mato/gmail-mcp)

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.

Available Tools

Messages

| Tool | Description | |------|-------------| | gmail_search | Search messages using Gmail query syntax (e.g. from:user@example.com, is:unread) | | 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_archive | Archive a message (remove from inbox) | | gmail_batch_archive | Archive multiple messages | | gmail_trash | Move a message to trash | | gmail_batch_trash | Move multiple messages to trash | | gmail_untrash | Remove a message from trash | | gmail_mark_read | Mark a message as read | | gmail_mark_unread | Mark a message 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 |