Skip to main content
Glama
jeffmm

gmail-fast-mcp

by jeffmm

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 auth

This 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/oauth2callback

3. Run the Server

uv run python -m gmail_fast_mcp

MCP 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_email

Send an email (text/html/multipart, attachments, threading)

draft_email

Create an email draft

read_email

Retrieve email content and attachment metadata

search_emails

Search using Gmail query syntax

modify_email

Add/remove labels on a message

trash_email

Move a message to trash

batch_modify_emails

Modify labels on multiple messages

batch_trash_emails

Trash multiple messages

list_email_labels

List all Gmail labels

create_label

Create a new label

update_label

Update label name/visibility

delete_label

Delete a user label

get_or_create_label

Find existing label or create it

create_filter

Create a filter with custom criteria/actions

list_filters

List all filters

get_filter

Get filter details

delete_filter

Delete a filter

create_filter_from_template

Create a filter from a preset template

download_attachment

Download an attachment to disk

Gmail API Scopes

  • gmail.modify — Read, send, modify emails and labels

  • gmail.settings.basic — Manage filters and settings

F
license - not found
-
quality - not tested
D
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • A
    license
    -
    quality
    D
    maintenance
    A 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.
    Last updated
    417
    MIT
  • A
    license
    -
    quality
    D
    maintenance
    A comprehensive MCP server for Gmail, providing 17 tools to read, send, search, and manage emails with OAuth2 authentication, including attachment handling and privacy features.
    Last updated
    202
    MIT
  • A
    license
    -
    quality
    D
    maintenance
    An MCP server that provides Gmail access for LLMs, enabling email composition, sending, searching, and label management via the Gmail API.
    Last updated
    MIT

View all related MCP servers

Related MCP Connectors

  • Read, search, send, organize, draft and schedule email across your inboxes from any MCP client.

  • Manage Gmail messages, threads, labels, drafts, and settings from your workflows. Send and organiz…

  • Manage Gmail end-to-end: search, read, send, draft, label, and organize threads. Automate workflow…

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/jeffmm/gmail-fast-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server