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); 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
