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 Plugin 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
      D
      maintenance
      An MCP server that enables Gmail integration, allowing users to manage emails (send, receive, read, trash, mark as read) directly through MCP clients like Claude Desktop.
      1
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      A Model Context Protocol server that enables full management of Gmail accounts, including messages, threads, labels, and drafts. It leverages the Gmail API to allow searching, sending, and organizing emails via secure OAuth2 authentication.
      MIT
    • F
      license
      Not graded
      quality
      B
      maintenance
      Enables interacting with multiple Gmail accounts through a single MCP server, supporting search, labels, drafts, and thread management with per-account OAuth.
      1
      -