Server Details
Manage Gmail end-to-end: search, read, send, draft, label, and organize threads. Automate workflow…
- Status
- Healthy
- Last Tested
- Transport
- Streamable HTTP
- URL
- Repository
- sebastianall1977/gmail-mcp
- GitHub Stars
- 0
Available Tools
64 toolsadd_delegateTry in Inspector
Adds a delegate to the specified account
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| delegateEmail | Yes | Email address of delegate to add |
batch_delete_messagesTry in Inspector
Delete multiple messages
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ids | Yes | The IDs of the messages to delete |
batch_modify_messagesTry in Inspector
Modify the labels on multiple messages
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ids | Yes | The IDs of the messages to modify | |
| addLabelIds | No | A list of label IDs to add to the messages | |
| removeLabelIds | No | A list of label IDs to remove from the messages |
create_draftTry in Inspector
Create a draft email in Gmail. Note the mechanics of the raw parameter.
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cc | No | List of CC recipient email addresses | |
| to | No | List of recipient email addresses | |
| bcc | No | List of BCC recipient email addresses | |
| raw | No | The entire email message in base64url encoded RFC 2822 format, ignores params.to, cc, bcc, subject, body, includeBodyHtml if provided | |
| body | No | The body of the email | |
| subject | No | The subject of the email | |
| threadId | No | The thread ID to associate this draft with | |
| includeBodyHtml | No | Whether to include the parsed HTML in the return for each body, excluded by default because they can be excessively large |
create_filterTry in Inspector
Creates a filter
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| action | Yes | Actions to perform on messages matching the criteria | |
| criteria | Yes | Filter criteria |
create_forwarding_addressTry in Inspector
Creates a forwarding address
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| forwardingEmail | Yes | An email address to which messages can be forwarded |
create_labelTry in Inspector
Create a new label
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | The display name of the label | |
| color | No | The color settings for the label | |
| labelListVisibility | No | The visibility of the label in the label list | |
| messageListVisibility | No | The visibility of messages with this label in the message list |
create_send_asTry in Inspector
Creates a custom send-as alias
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| isPrimary | No | Whether this address is the primary address | |
| signature | No | An optional HTML signature | |
| displayName | No | A name that appears in the 'From:' header | |
| sendAsEmail | Yes | The email address that appears in the 'From:' header | |
| treatAsAlias | No | Whether Gmail should treat this address as an alias | |
| replyToAddress | No | An optional email address that is included in a 'Reply-To:' header |
delete_draftTry in Inspector
Delete a draft
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | The ID of the draft to delete |
delete_filterTry in Inspector
Deletes a filter
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | The ID of the filter to be deleted |
delete_forwarding_addressTry in Inspector
Deletes the specified forwarding address
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| forwardingEmail | Yes | The forwarding address to be deleted |
delete_labelTry in Inspector
Delete a label
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | The ID of the label to delete |
delete_messageTry in Inspector
Immediately and permanently delete a message
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | The ID of the message to delete |
delete_send_asTry in Inspector
Deletes the specified send-as alias
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sendAsEmail | Yes | The send-as alias to be deleted |
delete_smime_infoTry in Inspector
Deletes the specified S/MIME config for the specified send-as alias
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | The immutable ID for the S/MIME config | |
| sendAsEmail | Yes | The email address that appears in the 'From:' header |
delete_threadTry in Inspector
Delete a thread
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | The ID of the thread to delete |
get_attachmentTry in Inspector
Get a message attachment
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | The ID of the attachment | |
| messageId | Yes | ID of the message containing the attachment |
get_auto_forwardingTry in Inspector
Gets auto-forwarding settings
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
get_delegateTry in Inspector
Gets the specified delegate
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| delegateEmail | Yes | The email address of the delegate to retrieve |
get_draftTry in Inspector
Get a specific draft by ID
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | The ID of the draft to retrieve | |
| includeBodyHtml | No | Whether to include the parsed HTML in the return for each body, excluded by default because they can be excessively large |
get_filterTry in Inspector
Gets a filter
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | The ID of the filter to be fetched |
get_forwarding_addressTry in Inspector
Gets the specified forwarding address
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| forwardingEmail | Yes | The forwarding address to be retrieved |
get_imapTry in Inspector
Gets IMAP settings
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
get_labelTry in Inspector
Get a specific label by ID
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | The ID of the label to retrieve |
get_languageTry in Inspector
Gets language settings
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
get_messageTry in Inspector
Get a specific message by ID with format options
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | The ID of the message to retrieve | |
| includeBodyHtml | No | Whether to include the parsed HTML in the return for each body, excluded by default because they can be excessively large |
get_popTry in Inspector
Gets POP settings
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
get_profileTry in Inspector
Get the current user's Gmail profile
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
get_send_asTry in Inspector
Gets the specified send-as alias
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sendAsEmail | Yes | The send-as alias to be retrieved |
get_smime_infoTry in Inspector
Gets the specified S/MIME config for the specified send-as alias
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | The immutable ID for the S/MIME config | |
| sendAsEmail | Yes | The email address that appears in the 'From:' header |
get_threadTry in Inspector
Get a specific thread by ID
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | The ID of the thread to retrieve | |
| includeBodyHtml | No | Whether to include the parsed HTML in the return for each body, excluded by default because they can be excessively large |
get_vacationTry in Inspector
Get vacation responder settings
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
insert_smime_infoTry in Inspector
Insert (upload) the given S/MIME config for the specified send-as alias
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| pkcs12 | Yes | PKCS#12 format containing a single private/public key pair and certificate chain | |
| sendAsEmail | Yes | The email address that appears in the 'From:' header | |
| encryptedKeyPassword | Yes | Encrypted key password |
list_delegatesTry in Inspector
Lists the delegates for the specified account
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
list_draftsTry in Inspector
List drafts in the user's mailbox
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | Only return drafts matching the specified query. Supports the same query format as the Gmail search box | |
| maxResults | No | Maximum number of drafts to return. Accepts values between 1-500 | |
| includeBodyHtml | No | Whether to include the parsed HTML in the return for each body, excluded by default because they can be excessively large | |
| includeSpamTrash | No | Include drafts from SPAM and TRASH in the results |
list_filtersTry in Inspector
Lists the message filters of a Gmail user
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
list_forwarding_addressesTry in Inspector
Lists the forwarding addresses for the specified account
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
list_labelsTry in Inspector
List all labels in the user's mailbox
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
list_messagesTry in Inspector
List messages in the user's mailbox with optional filtering
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | Only return messages matching the specified query. Supports the same query format as the Gmail search box | |
| labelIds | No | Only return messages with labels that match all of the specified label IDs | |
| pageToken | No | Page token to retrieve a specific page of results | |
| maxResults | No | Maximum number of messages to return. Accepts values between 1-500 | |
| includeBodyHtml | No | Whether to include the parsed HTML in the return for each body, excluded by default because they can be excessively large | |
| includeSpamTrash | No | Include messages from SPAM and TRASH in the results |
list_send_asTry in Inspector
Lists the send-as aliases for the specified account
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
list_smime_infoTry in Inspector
Lists S/MIME configs for the specified send-as alias
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sendAsEmail | Yes | The email address that appears in the 'From:' header |
list_threadsTry in Inspector
List threads in the user's mailbox
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | Only return threads matching the specified query | |
| labelIds | No | Only return threads with labels that match all of the specified label IDs | |
| pageToken | No | Page token to retrieve a specific page of results | |
| maxResults | No | Maximum number of threads to return | |
| includeBodyHtml | No | Whether to include the parsed HTML in the return for each body, excluded by default because they can be excessively large | |
| includeSpamTrash | No | Include threads from SPAM and TRASH in the results |
modify_messageTry in Inspector
Modify the labels on a message
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | The ID of the message to modify | |
| addLabelIds | No | A list of label IDs to add to the message | |
| removeLabelIds | No | A list of label IDs to remove from the message |
modify_threadTry in Inspector
Modify the labels applied to a thread
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | The ID of the thread to modify | |
| addLabelIds | No | A list of label IDs to add to the thread | |
| removeLabelIds | No | A list of label IDs to remove from the thread |
patch_labelTry in Inspector
Patch an existing label (partial update)
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | The ID of the label to patch | |
| name | No | The display name of the label | |
| color | No | The color settings for the label | |
| labelListVisibility | No | The visibility of the label in the label list | |
| messageListVisibility | No | The visibility of messages with this label in the message list |
patch_send_asTry in Inspector
Patches the specified send-as alias
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| isPrimary | No | Whether this address is the primary address | |
| signature | No | An optional HTML signature | |
| displayName | No | A name that appears in the 'From:' header | |
| sendAsEmail | Yes | The send-as alias to be updated | |
| treatAsAlias | No | Whether Gmail should treat this address as an alias | |
| replyToAddress | No | An optional email address that is included in a 'Reply-To:' header |
remove_delegateTry in Inspector
Removes the specified delegate
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| delegateEmail | Yes | Email address of delegate to remove |
send_draftTry in Inspector
Send an existing draft
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | The ID of the draft to send |
send_messageTry in Inspector
Send an email message to specified recipients. Note the mechanics of the raw parameter.
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cc | No | List of CC recipient email addresses | |
| to | No | List of recipient email addresses | |
| bcc | No | List of BCC recipient email addresses | |
| raw | No | The entire email message in base64url encoded RFC 2822 format, ignores params.to, cc, bcc, subject, body, includeBodyHtml if provided | |
| body | No | The body of the email | |
| subject | No | The subject of the email | |
| threadId | No | The thread ID to associate this message with | |
| includeBodyHtml | No | Whether to include the parsed HTML in the return for each body, excluded by default because they can be excessively large |
set_default_smime_infoTry in Inspector
Sets the default S/MIME config for the specified send-as alias
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | The immutable ID for the S/MIME config | |
| sendAsEmail | Yes | The email address that appears in the 'From:' header |
stop_mail_watchTry in Inspector
Stop receiving push notifications for the given user mailbox
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
trash_messageTry in Inspector
Move a message to the trash
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | The ID of the message to move to trash |
trash_threadTry in Inspector
Move a thread to the trash
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | The ID of the thread to move to trash |
untrash_messageTry in Inspector
Remove a message from the trash
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | The ID of the message to remove from trash |
untrash_threadTry in Inspector
Remove a thread from the trash
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | The ID of the thread to remove from trash |
update_auto_forwardingTry in Inspector
Updates automatic forwarding settings
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| enabled | Yes | Whether all incoming mail is automatically forwarded to another address | |
| disposition | Yes | The state in which messages should be left after being forwarded | |
| emailAddress | Yes | Email address to which messages should be automatically forwarded |
update_imapTry in Inspector
Updates IMAP settings
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| enabled | Yes | Whether IMAP is enabled for the account | |
| maxFolderSize | No | An optional limit on the number of messages that can be accessed through IMAP | |
| expungeBehavior | No | The action that will be executed on a message when it is marked as deleted and expunged from the last visible IMAP folder |
update_labelTry in Inspector
Update an existing label
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | The ID of the label to update | |
| name | No | The display name of the label | |
| color | No | The color settings for the label | |
| labelListVisibility | No | The visibility of the label in the label list | |
| messageListVisibility | No | The visibility of messages with this label in the message list |
update_languageTry in Inspector
Updates language settings
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| displayLanguage | Yes | The language to display Gmail in, formatted as an RFC 3066 Language Tag |
update_popTry in Inspector
Updates POP settings
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| disposition | Yes | The action that will be executed on a message after it has been fetched via POP | |
| accessWindow | Yes | The range of messages which are accessible via POP |
update_send_asTry in Inspector
Updates a send-as alias
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| isPrimary | No | Whether this address is the primary address | |
| signature | No | An optional HTML signature | |
| displayName | No | A name that appears in the 'From:' header | |
| sendAsEmail | Yes | The send-as alias to be updated | |
| treatAsAlias | No | Whether Gmail should treat this address as an alias | |
| replyToAddress | No | An optional email address that is included in a 'Reply-To:' header |
update_vacationTry in Inspector
Update vacation responder settings
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| endTime | No | End time for sending auto-replies (epoch ms) | |
| startTime | No | Start time for sending auto-replies (epoch ms) | |
| enableAutoReply | Yes | Whether the vacation responder is enabled | |
| responseSubject | No | Optional subject line for the vacation responder auto-reply | |
| restrictToDomain | No | Whether responses are only sent to users in the same domain | |
| restrictToContacts | No | Whether responses are only sent to contacts | |
| responseBodyPlainText | Yes | Response body in plain text format |
verify_send_asTry in Inspector
Sends a verification email to the specified send-as alias
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sendAsEmail | Yes | The send-as alias to be verified |
watch_mailboxTry in Inspector
Watch for changes to the user's mailbox
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| labelIds | No | Label IDs to restrict notifications to | |
| topicName | Yes | The name of the Cloud Pub/Sub topic to publish notifications to | |
| labelFilterAction | No | Whether to include or exclude the specified labels |
FAQ
How do I claim this server?
To claim this server, publish a /.well-known/glama.json file on your server's domain with the following structure:
{
"$schema": "https://glama.ai/mcp/schemas/connector.json",
"maintainers": [
{
"email": "your-email@example.com"
}
]
}
The email address must match the email associated with your Glama account. Once verified, the server will appear as claimed by you.
What are the benefits of claiming a server?
- Control your server's listing on Glama, including description and metadata
- Receive usage reports showing how your server is being used
- Get monitoring and health status updates for your server
Try in Browser
Your Connectors
Sign in to create a connector for this server.