Gmail MCP server for Claude, ChatGPT, Claude Code and Cursor
Access, send, manage, and modify emails, threads, drafts, labels, and user settings in Gmail.
Examples of what your AI apps can do in Gmail. You'll see the exact list of tools after you connect it.
send_draft
ToolThis action sends an existing Gmail draft to the recipients already defined in it. The draft is sent as-is with its pre-configured recipients, subject, and body.
delete_draft
ToolThis action deletes a specified Gmail draft by its ID. It requires the user's permissions to perform this operation on the specified draft.
create_label
ToolThis action creates a new label in the user's Gmail account with the specified properties. It ensures that the label name is unique and validates the color selections for the label.
patch_label
ToolThis action modifies the properties of an existing Gmail label. It allows the user to update attributes such as the label's name, visibility, and color.
create_email_draft
ToolThis action creates a draft email in Gmail. It allows specifying recipients, subject, body content, and attachments, enabling users to prepare emails for sending at a later time.
fetch_emails
ToolThis action retrieves a list of email messages from a specified Gmail account. It allows for filtering the messages based on various parameters such as label IDs and search queries, as well as controlling the level of detail returned for each message.
fetch_message_by_message_id
ToolThis action retrieves an email message from Gmail using its unique message ID. It allows users to access information about the email content based on the provided user ID.
get_attachment
ToolThis action fetches a specific attachment from a user's Gmail messages using the provided message and attachment IDs. It ensures that the returned attachment is valid and is appropriately decoded for the user.
list_drafts
ToolThis action retrieves a list of email drafts for the authenticated user's Gmail account. It allows the user to specify the number of drafts to return and whether to fetch detailed information for each draft.
move_to_trash
ToolThis action allows the user to move a specified email message to the trash. It requires the message ID and the user's email address or 'me' to identify the user.
reply_to_thread
ToolThis action allows users to reply to an existing email thread in Gmail. Users must provide the thread ID and at least one recipient's email address to successfully send their reply.
search_people
ToolThis action searches your Google Contacts by name, email, phone number, or organization. You can choose to include 'Other Contacts' (people you've interacted with but haven't explicitly saved) for a more comprehensive search.
send_email
ToolThis action sends an email using the Gmail API from the authenticated user's email account. It requires at least one recipient and either a subject or body for the email to be sent. To attach files, you must first obtain an s3key by downloading or uploading the file using another action, then provide it in the attachment parameter.
add_label_to_email
ToolThis action allows you to add or remove labels from a specific email message in Gmail. By providing the user's ID and the message ID, you can modify the labels associated with that email, helping to organize or categorize messages as needed.
fetch_message_by_thread_id
ToolThis action retrieves messages from a specific Gmail thread. It requires the thread's ID and the user's ID to access the messages within that thread.
get_contacts
ToolThis action retrieves the list of contacts associated with the authenticated user's Google account. It allows for filtering the fields that are returned and supports pagination for large sets of contacts.
get_people
ToolThis action fetches details about a specific person identified by the resource name or retrieves a list of 'Other Contacts' if requested. You can specify which person-related fields you want to return.
get_profile
ToolThis action retrieves the Gmail profile information for a specified user. You can obtain details such as the user's primary email address and message totals.
list_labels
ToolThis action retrieves all labels associated with a specified Gmail account. It is useful for understanding the organization of emails for the user by categorizing them into different labels.
list_threads
ToolThis action fetches a list of email threads associated with a specific user. It provides options to filter results and paginate through them based on the specified parameters.
modify_thread_labels
ToolThis action modifies the labels of a specified Gmail thread by adding or removing existing label IDs. It allows for organization of the thread's messages based on the user's input labels.
remove_label
ToolPermanently deletes a specific, existing user-created gmail label by its id for a user; cannot delete system labels.
Free. No card needed.
How to connect Gmail
- 1Create your free ContextGate account.
- 2Go to Connections → Add Connection, search for Gmail and sign in to Gmail.
- 3Add ContextGate to Claude, Cursor or ChatGPT (the Setup page shows you how), then ask it to use Gmail.
What you get with Gmail and ContextGate
- Your AI apps can use Gmail Claude, Cursor, ChatGPT and other AI apps reach Gmail through the one ContextGate connection you add to them.
- You choose which tools they can use Switch off any Gmail tool you don't want used. It's hidden from your AI apps and refused if called.
- Every call is checked and recorded Your policies check each call (for example, personal data is hidden and secrets are blocked), and Activity keeps a record of it.
ContextGate sees only the tool calls that go through it, not your AI app's built-in tools or your chats.
Select a tool on the left to see its parameters
What you get with Gmail and ContextGate
- Your AI apps can use Gmail: Claude, Cursor, ChatGPT and other AI apps reach Gmail through the one ContextGate connection you add to them.
- You choose which tools they can use: Switch off any Gmail tool you don't want used. It's hidden from your AI apps and refused if called.
- Every call is checked and recorded: Your policies check each call (for example, personal data is hidden and secrets are blocked), and Activity keeps a record of it.
ContextGate sees only the tool calls that go through it, not your AI app's built-in tools or your chats.
Free. No card needed.
How to connect Gmail
- Create your free ContextGate account.
- Go to Connections → Add Connection, search for Gmail and sign in to Gmail.
- Add ContextGate to Claude, Cursor or ChatGPT (the Setup page shows you how), then ask it to use Gmail.