google_oauth_refresh_tokens
Refresh OAuth access tokens and update them in the token file
LABSCO SUMMARY
Gmail with the attachment half actually finished.
Sending mail from an assistant is common; sending it with a file from Google Drive attached, or pulling every attachment off a thread onto disk, is not. Credentials are your own — an OAuth client or a service account with impersonation — so nothing is brokered elsewhere.
What it is
A collection of Google-native tools for MCP — Gmail, Calendar, Drive and Tasks — run through bunx and integrated with clients such as Claude and Cursor. Attachment handling is the recent addition: sending from local files or Google Drive in the same message, drafts with attachments, and downloading every attachment on an email.
What you get
- Email sent with attachments from local file paths or Google Drive file ids, mixed in the same message (google_gmail_send_email)
- Drafts created with attachments (google_gmail_draft_email)
- Every attachment on an email downloaded to local storage (google_gmail_download_attachments)
- Automatic MIME type detection, filename sanitisation, and custom filenames that override the original
- Gmail's 25MB limit enforced before the send, and name conflicts resolved by automatic renaming
- The Downloads folder detected automatically on Windows, macOS and Linux
- Calendar, Drive and Tasks tools alongside Gmail in the same server — its source registers 35 in all — and a one-click .mcpb install from the releases page
Requirements
Bun, since it runs through bunx. Then either OAuth — a client id, client secret and a token path you choose — or a service account with a client email, private key and a user to impersonate. One or the other, not both.
Setup effort
One command plus credentials — bunx --no-cache google-mcp@latest, then supply credentials
USE CASES
01
Sending a file someone asked for
The attachment comes from a local path and goes out with the message, with MIME type detection and the 25MB limit checked before the send rather than after it.
02
Attaching something that lives in Drive
Drive file ids attach directly, so a document does not have to be downloaded and re-uploaded to be sent.
03
Preparing a message you want to check first
A draft is created with its attachments in place, so the last read happens in Gmail before anything goes out.
04
Getting the attachments off a thread
Every attachment downloads to local storage, with the Downloads folder found automatically and name conflicts resolved by renaming.
35 tools
Listed in project code.
google_oauth_reauthenticate
Delete existing tokens and start fresh OAuth authentication flow
google_calendar_set_default
Set the default calendar ID for operations
google_calendar_list_calendars
List all available calendars
google_calendar_create_event
Create a new event in Google Calendar
google_calendar_get_events
Retrieve upcoming events from Google Calendar
google_calendar_get_event
Get detailed information about a specific event
google_calendar_update_event
Update an existing event in Google Calendar
google_calendar_delete_event
Delete an event from Google Calendar
google_calendar_find_free_time
Find available time slots between events
google_gmail_list_labels
List all available Gmail labels
google_gmail_list_emails
List emails from a specific label or folder
google_gmail_get_email
Get detailed information about a specific email
google_gmail_get_email_by_index
Get email by its index from the most recent search results
google_gmail_send_email
Send a new email
google_gmail_draft_email
Create a draft email
google_gmail_delete_email
Delete or trash an email
google_gmail_modify_labels
Add or remove labels from an email
google_gmail_download_attachments
Download all attachments from a specific email
google_drive_list_files
List files from Google Drive
google_drive_get_file_content
Get the content of a file from Google Drive
google_drive_create_file
Create a new file in Google Drive
google_drive_update_file
Update the content of an existing file in Google Drive
google_drive_delete_file
Delete a file from Google Drive
google_drive_share_file
Share a file with another user
google_tasks_set_default_list
Set the default task list ID for operations
google_tasks_list_tasklists
List all available task lists
google_tasks_list_tasks
List tasks from a task list
google_tasks_get_task
Get details about a specific task
google_tasks_create_task
Create a new task
google_tasks_update_task
Update an existing task
google_tasks_complete_task
Mark a task as completed
google_tasks_delete_task
Delete a task
google_tasks_create_tasklist
Create a new task list
google_tasks_delete_tasklist
Delete a task list
BEFORE YOU INSTALL
What to know first
Tools you get
35 tools registered in the project's code.
Requires
- bunx on PATH
- Either an OAuth client (GOOGLE_OAUTH_CLIENT_ID, GOOGLE_OAUTH_CLIENT_SECRET, GOOGLE_OAUTH_TOKEN_PATH) or a service account (GOOGLE_CLIENT_EMAIL, GOOGLE_PRIVATE_KEY, GMAIL_USER_TO_IMPERSONATE) — one or the other, not both
Where it runs
Both documented setups run the server on your machine.
INSTALLATION
Connect your client
Server setup
TERMINAL
bunx --no-cache google-mcp@latestMCP Clients
Claude Desktop — OAuth
CLAUDE DESKTOP — OAUTH · JSON
{
"mcpServers": {
"google-mcp": {
"command": "bunx",
"args": [
"--no-cache",
"google-mcp@latest"
],
"env": {
"GOOGLE_OAUTH_CLIENT_ID": "<YOUR_CLIENT_ID>",
"GOOGLE_OAUTH_CLIENT_SECRET": "<YOUR_CLIENT_SECRET>",
"GOOGLE_OAUTH_TOKEN_PATH": "<YOUR_GOOGLE_OAUTH_TOKEN_PATH>"
}
}
}
}Claude Desktop — Service Account
CLAUDE DESKTOP — SERVICE ACCOUNT · JSON
{
"mcpServers": {
"google-mcp": {
"command": "bunx",
"args": [
"--no-cache",
"google-mcp@latest"
],
"env": {
"GOOGLE_CLIENT_EMAIL": "<YOUR_SERVICE_ACCOUNT_EMAIL>",
"GOOGLE_PRIVATE_KEY": "<YOUR_SERVICE_ACCOUNT_PRIVATE_KEY>",
"GMAIL_USER_TO_IMPERSONATE": "<YOUR_GMAIL_USER_TO_IMPERSONATE>"
}
}
}
}
