Headless Gmail

To publish the Docker image for multiple platforms, you can use thedocker buildxcommand. Follow these steps:
-

Create a new builder instance(if you haven't already):

Build and push the image for multiple platforms:

docker buildx build --platform linux/amd64,linux/arm64,linux/arm/v7 -t buryhuang/mcp-headless-gmail:latest --push .

Verify the image is available for the specified platforms:

docker buildx imagetools inspect buryhuang/mcp-headless-gmail:latest

The server provides Gmail functionality through MCP tools. Authentication handling is simplified with a dedicated token refresh tool.

When using an MCP client like Claude, you have two main ways to handle authentication:

Refreshing Tokens (First Step or When Tokens Expire)

If you have both access and refresh tokens:

{ "google_access_token": "your_access_token", "google_refresh_token": "your_refresh_token", "google_client_id": "your_client_id", "google_client_secret": "your_client_secret" }

If your access token has expired, you can refresh with just the refresh token:

{ "google_refresh_token": "your_refresh_token", "google_client_id": "your_client_id", "google_client_secret": "your_client_secret" }

This will return a new access token and its expiration time, which you can use for subsequent calls.

Retrieves recent emails with the first 1k characters of each email body:

{ "google_access_token": "your_access_token", "max_results": 5, "unread_only": false }

- Email metadata (id, threadId, from, to, subject, date, etc.)
- First 1000 characters of the email body
- body_size_bytes: Total size of the email body in bytes
- contains_full_body: Boolean indicating if the entire body is included (true) or truncated (false)

For emails with bodies larger than 1k characters, you can retrieve the full content in chunks:

{ "google_access_token": "your_access_token", "message_id": "message_id_from_get_recent_emails", "offset": 0 }

You can also get email content by thread ID:

{ "google_access_token": "your_access_token", "thread_id": "thread_id_from_get_recent_emails", "offset": 1000 }

- A 1k chunk of the email body starting from the specified offset
- body_size_bytes: Total size of the email body
- chunk_size: Size of the returned chunk
- contains_full_body: Boolean indicating if the chunk contains the remainder of the body

To retrieve the entire email body of a long message, make sequential calls increasing the offset by 1000 each time untilcontains_full_bodyis true.

{ "google_access_token": "your_access_token", "to": "recipient@example.com", "subject": "Hello from MCP Gmail", "body": "This is a test email sent via MCP Gmail server", "html_body": "<p>This is a <strong>test email</strong> sent via MCP Gmail server</p>" }

- Start by calling thegmail_refresh_tokentool with either:

- Your full credentials (access token, refresh token, client ID, and client secret), or
- Just your refresh token, client ID, and client secret if the access token has expired

This approach simplifies most API calls by not requiring client credentials for every operation, while still enabling token refresh when needed.

- https://www.googleapis.com/auth/gmail.readonly(for reading emails)
- https://www.googleapis.com/auth/gmail.send(for sending emails)

This server implements automatic token refreshing. When your access token expires, the Google API client will use the refresh token, client ID, and client secret to obtain a new access token without requiring user intervention.

This server requires direct access to your Google API credentials. Always keep your tokens and credentials secure and never share them with untrusted parties.

AI personal assistant for email Inbox Zero

Send emails via SMTP. Requires SMTP server credentials to be configured through environment variables.

Query live Gmail data using LLMs via CData's read-only MCP server.

Tools for common Gmail operations, such as sending emails.

Provides comprehensive integration with Gmail for reading, searching, and sending emails.

An MCP server for Gmail, allowing AI assistants to manage emails through natural language.

Search and delete emails in your Gmail account.

Enables AI assistants to manage Gmail through natural language interactions.

An MCP server for integrating Gmail with auto-authentication support.