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.

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