windsornguyen

gmail-mcp

by windsornguyen

インテグレーション

An MCP server that enables management of Gmail messages, threads, labels, and drafts through OAuth2 authentication via the Dedalus framework. It allows users to perform operations like searching messages, sending emails, and organizing conversations using the Gmail API.

GitHubで見る

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