gmail-fast-mcp
Provides tools for email operations (send, read, search, draft, modify, trash, batch operations), label management (list, create, update, delete, get-or-create), filter management (create, list, get, delete, create from template), and attachment handling (download) via the Gmail API.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@gmail-fast-mcp Send an email to john@example.com about the project update"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
gmail-fast-mcp
Gmail MCP server built with FastMCP. Provides 19 tools for email operations, label management, filter management, and attachment handling via the Gmail API.
Setup
1. Google OAuth Credentials
Place your Google Cloud OAuth client credentials at ~/.gmail-mcp/gcp-oauth.keys.json (or in the project directory — they'll be copied automatically).
2. Authenticate
uv run python -m gmail_fast_mcp authThis opens a browser for the OAuth flow and saves tokens to ~/.gmail-mcp/credentials.json.
For cloud environments with a custom callback URL:
uv run python -m gmail_fast_mcp auth https://your-domain.com/oauth2callback3. Run the Server
uv run python -m gmail_fast_mcpMCP Client Configuration
{
"mcpServers": {
"gmail": {
"command": "uv",
"args": ["run", "--directory", "/path/to/gmail-fast-mcp", "python", "-m", "gmail_fast_mcp"]
}
}
}Related MCP server: Gmail MCP Server
Tools
Tool | Description |
| Send an email (text/html/multipart, attachments, threading) |
| Create an email draft |
| Retrieve email content and attachment metadata |
| Search using Gmail query syntax |
| Add/remove labels on a message |
| Move a message to trash |
| Modify labels on multiple messages |
| Trash multiple messages |
| List all Gmail labels |
| Create a new label |
| Update label name/visibility |
| Delete a user label |
| Find existing label or create it |
| Create a filter with custom criteria/actions |
| List all filters |
| Get filter details |
| Delete a filter |
| Create a filter from a preset template |
| Download an attachment to disk |
Gmail API Scopes
gmail.modify— Read, send, modify emails and labelsgmail.settings.basic— Manage filters and settings
Available Tools
19 toolsbatch_modify_emailsB
Modify labels for multiple emails in batches.
Inputs: message_ids (required), batch_size, add_label_ids, remove_label_ids. Returns: result
batch_trash_emailsA
Move multiple emails to trash in batches.
Inputs: message_ids (required), batch_size. Returns: result
create_filterB
Create a new Gmail filter with custom criteria and actions.
Inputs: action (required), criteria (required). Returns: result
create_filter_from_templateB
Create a filter using a pre-defined template for common scenarios.
Inputs: template (required), archive, label_ids, search_text, +6 more. Returns: result
create_labelC
Create a new Gmail label.
Inputs: name (required), label_list_visibility, message_list_visibility. Returns: result
delete_filterB
Delete a Gmail filter.
Inputs: filter_id (required). Returns: result
delete_labelB
Delete a Gmail label.
Inputs: id (required). Returns: result
download_attachmentB
Download an email attachment to a specified location.
Inputs: message_id (required), attachment_id (required), filename, save_path. Returns: result
draft_emailC
Create an email draft.
Inputs: to (required), body (required), subject (required), cc, +6 more. Returns: result
get_filterA
Get details of a specific Gmail filter.
Inputs: filter_id (required). Returns: result
get_or_create_labelA
Get an existing label by name or create it if it doesn't exist.
Inputs: name (required), label_list_visibility, message_list_visibility. Returns: result
list_email_labelsA
Retrieve all available Gmail labels.
Inputs: no named parameters. Returns: result
list_filtersA
Retrieve all Gmail filters.
Inputs: no named parameters. Returns: result
modify_emailC
Modify email labels (move to different folders).
Inputs: message_id (required), label_ids, add_label_ids, remove_label_ids. Returns: result
read_emailC
Retrieve the content of a specific email.
Inputs: message_id (required). Returns: result
search_emailsB
Search for emails using Gmail search syntax.
Inputs: query (required), max_results. Returns: result
send_emailC
Send a new email.
Inputs: to (required), body (required), subject (required), cc, +6 more. Returns: result
trash_emailB
Move an email to the trash.
Inputs: message_id (required). Returns: result
update_labelB
Update an existing Gmail label.
Inputs: id (required), name, label_list_visibility, message_list_visibility. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 19 tools
Most tools target a distinct resource and action: labels, filters, emails, attachments, and drafts. The only real ambiguity is between modify_email and trash_email (both affect email placement) and between create_filter and create_filter_from_template, but the descriptions clarify the difference.
All tool names are lowercase snake_case and follow a verb_noun pattern, from list_email_labels to batch_trash_emails. Even compound operations like get_or_create_label and create_filter_from_template fit the pattern without mixing styles.
At 19 tools, the set sits in the 16-25 range that reads as heavy for an MCP server. That said, each tool has a role in Gmail's email/label/filter domain, so it is not extreme.
Labels and filters have full CRUD plus conveniences, and emails can be sent, read, searched, labeled, trashed, and have attachments downloaded. Missing draft lifecycle operations (send/update/list/delete) and restore/permanent-delete are the main gaps, but core workflows are still achievable.
Maintenance
Related MCP Connectors
A MCP server for Gmail that lets you search, read, and draft emails and replies.
Hosted MCP server for your Gmail, Outlook and IMAP mail, with mailboxes and scopes set per agent.
Email infrastructure for AI agents — send, receive, search, and reply to email over MCP.
An MCP server that provides email capabilities, hosted on Alpic platform
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceMCP server that integrates with Gmail to enable sending, reading, and managing emails through tools like send-email, trash-email, get-unread-emails, and read-email.73GPL 3.0
- FlicenseNot gradedqualityDmaintenanceA comprehensive MCP server providing 24 tools for full Gmail management, including email operations, label organization, and batch filtering. It features multi-account support and secure OAuth authentication for interacting with mailboxes via natural language.-
- FlicenseBqualityDmaintenanceA comprehensive MCP server for Gmail, providing 17 tools to read, send, search, and manage emails with OAuth2 authentication, including attachment handling and privacy features.18-
- AlicenseNot gradedqualityDmaintenanceAn MCP server that provides Gmail access for LLMs, enabling email composition, sending, searching, and label management via the Gmail API.MIT