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:[email protected], 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