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.

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