Faithk7 Gmail Mcp
A full-featured Gmail integration that wraps the official Gmail API with OAuth2 authentication. Exposes all the operations you'd expect: send and draft messages, manage threads and labels with custom colors, batch modify or delete emails, handle attachments, and configure settings like vacation responders and IMAP access. Includes history tracking for mailbox changes and push notification setup via watch_mailbox. Setup requires creating a Google Cloud OAuth client once per organization, then each user runs an auth script to generate their refresh token. Works locally via npx or remotely through Smithery's hosted infrastructure. Useful when you need Claude to read, triage, or respond to email directly from your workflows without bouncing through intermediate APIs.
- tools
- 65
- auth
- Secret needed
- transport
- HTTP
- last updated
- Sep 14, 2025
Tools
65 toolsPublic tool metadata for what this MCP can expose to an agent.
get_profileGet the current user's Gmail profile
Get the current user's Gmail profile
No parameter schema in public metadata yet.
stop_mail_watchStop receiving push notifications
Stop receiving push notifications
No parameter schema in public metadata yet.
watch_mailboxSet up push notifications for mailbox changes
Set up push notifications for mailbox changes
No parameter schema in public metadata yet.
list_messagesList messages with optional filtering
List messages with optional filtering
No parameter schema in public metadata yet.
get_messageGet a specific message
Get a specific message
No parameter schema in public metadata yet.
get_attachmentGet a message attachment
Get a message attachment
No parameter schema in public metadata yet.
modify_messageModify message labels
Modify message labels
No parameter schema in public metadata yet.
send_messageSend an email message to specified recipients
Send an email message to specified recipients
No parameter schema in public metadata yet.
delete_messagePermanently delete a message
Permanently delete a message
No parameter schema in public metadata yet.
trash_messageMove message to trash
Move message to trash
No parameter schema in public metadata yet.
untrash_messageRemove message from trash
Remove message from trash
No parameter schema in public metadata yet.
batch_modify_messagesModify multiple messages
Modify multiple messages
No parameter schema in public metadata yet.
batch_delete_messagesDelete multiple messages
Delete multiple messages
No parameter schema in public metadata yet.
list_labelsList all labels
List all labels
No parameter schema in public metadata yet.
get_labelGet a specific label
Get a specific label
No parameter schema in public metadata yet.
create_labelCreate a new label
Create a new label
No parameter schema in public metadata yet.
update_labelUpdate a label
Update a label
No parameter schema in public metadata yet.
patch_labelPartial update of a label
Partial update of a label
No parameter schema in public metadata yet.
delete_labelDelete a label
Delete a label
No parameter schema in public metadata yet.
list_threadsList email threads
List email threads
No parameter schema in public metadata yet.
get_threadGet a specific thread
Get a specific thread
No parameter schema in public metadata yet.
modify_threadModify thread labels
Modify thread labels
No parameter schema in public metadata yet.
trash_threadMove thread to trash
Move thread to trash
No parameter schema in public metadata yet.
untrash_threadRemove thread from trash
Remove thread from trash
No parameter schema in public metadata yet.
delete_threadDelete a thread
Delete a thread
No parameter schema in public metadata yet.
list_draftsList drafts in the user's mailbox
List drafts in the user's mailbox
No parameter schema in public metadata yet.
get_draftGet a specific draft by ID
Get a specific draft by ID
No parameter schema in public metadata yet.
create_draftCreate a draft email in Gmail
Create a draft email in Gmail
No parameter schema in public metadata yet.
update_draftReplace a draft's content
Replace a draft's content
No parameter schema in public metadata yet.
delete_draftDelete a draft
Delete a draft
No parameter schema in public metadata yet.
send_draftSend an existing draft
Send an existing draft
No parameter schema in public metadata yet.
get_auto_forwardingGet auto-forwarding settings
Get auto-forwarding settings
No parameter schema in public metadata yet.
update_auto_forwardingUpdate auto-forwarding settings
Update auto-forwarding settings
No parameter schema in public metadata yet.
get_imapGet IMAP settings
Get IMAP settings
No parameter schema in public metadata yet.
update_imapUpdate IMAP settings
Update IMAP settings
No parameter schema in public metadata yet.
get_popGet POP settings
Get POP settings
No parameter schema in public metadata yet.
update_popUpdate POP settings
Update POP settings
No parameter schema in public metadata yet.
get_vacationGet vacation responder settings
Get vacation responder settings
No parameter schema in public metadata yet.
update_vacationUpdate vacation responder
Update vacation responder
No parameter schema in public metadata yet.
get_languageGet language settings
Get language settings
No parameter schema in public metadata yet.
update_languageUpdate language settings
Update language settings
No parameter schema in public metadata yet.
list_delegatesList account delegates
List account delegates
No parameter schema in public metadata yet.
get_delegateGet a specific delegate
Get a specific delegate
No parameter schema in public metadata yet.
add_delegateAdd a delegate
Add a delegate
No parameter schema in public metadata yet.
remove_delegateRemove a delegate
Remove a delegate
No parameter schema in public metadata yet.
list_filtersList email filters
List email filters
No parameter schema in public metadata yet.
get_filterGet a specific filter
Get a specific filter
No parameter schema in public metadata yet.
create_filterCreate a new filter
Create a new filter
No parameter schema in public metadata yet.
delete_filterDelete a filter
Delete a filter
No parameter schema in public metadata yet.
list_forwarding_addressesList forwarding addresses
List forwarding addresses
No parameter schema in public metadata yet.
get_forwarding_addressGet a specific forwarding address
Get a specific forwarding address
No parameter schema in public metadata yet.
create_forwarding_addressCreate a forwarding address
Create a forwarding address
No parameter schema in public metadata yet.
delete_forwarding_addressDelete a forwarding address
Delete a forwarding address
No parameter schema in public metadata yet.
list_send_asList send-as aliases
List send-as aliases
No parameter schema in public metadata yet.
get_send_asGet a specific send-as alias
Get a specific send-as alias
No parameter schema in public metadata yet.
create_send_asCreate a send-as alias
Create a send-as alias
No parameter schema in public metadata yet.
update_send_asUpdate a send-as alias
Update a send-as alias
No parameter schema in public metadata yet.
patch_send_asPartial update of a send-as alias
Partial update of a send-as alias
No parameter schema in public metadata yet.
verify_send_asSend verification email
Send verification email
No parameter schema in public metadata yet.
delete_send_asDelete a send-as alias
Delete a send-as alias
No parameter schema in public metadata yet.
list_smime_infoList S/MIME configurations
List S/MIME configurations
No parameter schema in public metadata yet.
get_smime_infoGet a specific S/MIME config
Get a specific S/MIME config
No parameter schema in public metadata yet.
insert_smime_infoUpload a new S/MIME config
Upload a new S/MIME config
No parameter schema in public metadata yet.
set_default_smime_infoSet default S/MIME config
Set default S/MIME config
No parameter schema in public metadata yet.
delete_smime_infoDelete an S/MIME config
Delete an S/MIME config
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageReadme
Details
- Repository
- github.com/faithk7/gmail-mcp
- Category
- Communication & Messaging
- Transport
- HTTP
- Auth
- Required
- Registry
- MCP registry, active
Related Communication & Messaging MCP servers
View all
Prelimchat.prelim/prelimRead AI preliminary phone screens — your roles, candidate scores, transcripts, and analytics.0stars
Gmailio.github.mcp-z/mcp-gmailGmail integration with OAuth authentication, message search, batch operations, and Sheets export0stars
Gmailpulsemcp/mcp-serversMCP server for Gmail with OAuth2 (personal) and service account (Workspace) support.0stars
discord-mcppasympa/discord-mcpRun your Discord server from Claude, Cursor or VS Code: messages, moderation, roles, forums, events32stars
Telegram Archivegeiserx/telegram-archive-mcpSearch and read your archived Telegram chats and messages13stars