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

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

• Gmail API Overview

• Gmail API Reference