Skip to main content
Glama

gmail-mcp

A Gmail MCP server using OAuth2 bearer token auth via the Dedalus MCP framework.

Tools

Messages

  • gmail_list_messages - List messages with search queries

  • gmail_get_message - Get a specific message by ID

  • gmail_send_message - Send an email

  • gmail_trash_message - Move message to trash

  • gmail_untrash_message - Remove message from trash

  • gmail_modify_message - Add/remove labels on a message

Threads

  • gmail_list_threads - List email threads (conversations)

  • gmail_get_thread - Get a thread with all messages

  • gmail_trash_thread - Move thread to trash

Labels

  • gmail_list_labels - List all labels

  • gmail_get_label - Get label details

  • gmail_create_label - Create a new label

  • gmail_delete_label - Delete a user label

Drafts

  • gmail_list_drafts - List draft emails

  • gmail_get_draft - Get a draft by ID

  • gmail_create_draft - Create a draft

  • gmail_send_draft - Send a draft

  • gmail_delete_draft - Delete a draft

Profile

  • gmail_get_profile - Get user's Gmail profile

Related MCP server: Gmail MCP Server

Authentication

Gmail API requires OAuth2. The access token is provided at runtime via Dedalus credential exchange.

Required OAuth scopes (depending on operations):

  • https://www.googleapis.com/auth/gmail.readonly - Read-only access

  • https://www.googleapis.com/auth/gmail.send - Send emails

  • https://www.googleapis.com/auth/gmail.modify - Modify messages/labels

  • https://www.googleapis.com/auth/gmail.compose - Create drafts

Local Development

cd gmail-mcp
uv sync
uv run python src/main.py

API Reference

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      A Model Context Protocol server that enables AI assistants like Claude to interact with Gmail through natural language, providing comprehensive email management capabilities including sending, reading, organizing, searching, and managing drafts and labels.
      23
      GPL 3.0
    • A
      license
      Not graded
      quality
      Not graded
      maintenance
      A Model Context Protocol server that enables applications to interact with Gmail through a clean API, supporting email searching, sending, reading, and label management.
      MIT
    • -
      license
      Not graded
      quality
      Not graded
      maintenance
      A Model Context Protocol server that enables Claude to interact with Gmail through a secure OAuth2 connection, providing email management capabilities like listing, sending, deleting, and organizing emails.
      -
    • F
      license
      Not graded
      quality
      D
      maintenance
      This MCP server provides a natural language interface to the Gmail API, allowing users to interact with Gmail functionality (like emails, threads, labels, etc.) through the Model Context Protocol.
      -