com.mcparmory/google-gmail
PYPI · MCPARMORY-GOOGLE-GMAIL · 2 COMPONENTS · SCANNED SEP 20
Send, read, organize emails, manage labels, drafts, and filters
Available components
How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score → Why this is hard to score →
Supply Chain Security37
- Malware scan not yet available for this package.Unverified
- No known CVEs affecting this package version or its production dependencies.Pass
- Install-script risk not yet assessed.Unverified
- 2 of 46 dependencies flagged as unhealthy. View diagnostics → Partial
Provenance & Transparency32
- Source repository is publicly reachable at the declared URL. View diagnostics → Pass
- Provenance check failed: no build-provenance attestation is published. See how to fix → View diagnostics → Fail
- License check failed: the license (MIT License) isn't a recognized OSI-approved license. See how to fix → Fail
- Actively maintained (last published 130 days ago).Pass
- Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail
Schema Quality & AI Usability73
- AI-judged instruction clarity (excellent).Pass
- Context-footprint check failed: tool/resource definitions use about 8935 tokens (~141/item across 63 items; 63 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management90
- Stability observed for 27 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
Tool Coverage100
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 100% of tool parameters carry a description.Pass
Tool Safety89
- No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
- 11 of 19 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation; "send_draft" implies "send" and declares no destructiveHint at all, which the MCP spec reads as destructive by default. See how to fix → Partial
- An AI judge read all 63 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
- Implements a current MCP spec version (2026-07-28).Pass
How do I install the com.mcparmory/google-gmail MCP server?
com.mcparmory/google-gmail runs locally as a PyPI package, launched with uvx mcparmory-google-gmail. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.
pypi · mcparmory-google-gmail
claude mcp add com-mcparmory-google-gmail -- uvx mcparmory-google-gmail
{
"mcpServers": {
"com-mcparmory-google-gmail": {
"command": "uvx",
"args": [
"mcparmory-google-gmail"
]
}
}
} {
"servers": {
"com-mcparmory-google-gmail": {
"command": "uvx",
"args": [
"mcparmory-google-gmail"
]
}
}
} codex mcp add com-mcparmory-google-gmail -- uvx mcparmory-google-gmail
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"com-mcparmory-google-gmail": {
"type": "local",
"command": [
"uvx",
"mcparmory-google-gmail"
],
"enabled": true
}
}
} openclaw mcp add com-mcparmory-google-gmail --command uvx --arg mcparmory-google-gmail
mcp_servers:
com-mcparmory-google-gmail:
command: "uvx"
args: ["mcparmory-google-gmail"] {
"McpServers": {
"com-mcparmory-google-gmail": {
"Transport": "stdio",
"Command": "uvx",
"Arguments": [
"mcparmory-google-gmail"
]
}
}
} assistant mcp add com-mcparmory-google-gmail -t stdio -c uvx -a mcparmory-google-gmail
{
"mcpServers": {
"com-mcparmory-google-gmail": {
"command": "uvx",
"args": [
"mcparmory-google-gmail"
]
}
}
} Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 20 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 87 to 90. That category is still filling its 30-day observation window: 26 days of observed history at the previous scan, 27 at this one. The score rises as the window fills, whether or not the server changes.
- 18 Sept 26 −14
- Malware scan: pass → unverified ▼ security
- 17 Sept 26 +12
- Malware scan: unverified → pass ▲ security
- Stability: pass → 0.80 functional
- 16 Sept 26 0
- Stability: 0.97 → pass security
- 15 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 93 to 97. That category is still filling its 30-day observation window: 28 days of observed history at the previous scan, 29 at this one. The score rises as the window fills, whether or not the server changes.
- 14 Sept 26 −15
- Malware scan: pass → unverified ▼ security
- 13 Sept 26 +16
- Malware scan: unverified → pass ▲ security
- 12 Sept 26 −15
- Malware scan: pass → unverified ▼ security
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 20 Sept 2026 · Analysed pypi/mcparmory-google-gmail@1.0.4
Provenance No attestation
The registry publishes no build provenance for this version, so there is nothing to verify.
| Result | No attestation |
|---|---|
| Ecosystem | pypi |
Background: How many MCP packages publish verified provenance →
Dependencies 46 packages
| Packages resolved | 46 |
|---|---|
| Stale | 1 |
| No linked repository | 1 |
| Tree resolution | Complete |
Background: SBOMs and build attestations, explained →
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →
create_cse_identity Create CSE Identity ~104
Creates and configures a client-side encryption identity for sending encrypted mail from a user account. The S/MIME certificate is published to a shared domain-wide directory, enabling secure communication within a Google Workspace organization.
| Name | Type | Req | Description |
|---|---|---|---|
| emailAddress | string | – | The email address for the sending identity. Must be the primary email address of the authenticated user. |
| userId | string | yes | The requester's primary email address. Use the special value `me` to indicate the authenticated user. |
No output schema declared.
No examples provided.
create_cse_keypair Create CSE Keypair ~139
Creates and uploads a client-side encryption S/MIME public key certificate chain and private key metadata for Gmail. Requires either domain-wide delegation authority for administrators or hardware key encryption enabled for individual users.
| Name | Type | Req | Description |
|---|---|---|---|
| pkcs7 | string | – | The public key and its certificate chain in PKCS#7 format with PEM encoding and ASCII armor. |
| privateKeyMetadata | array | – | An ordered array of metadata objects for instances of this key pair's private key. Order significance and item structure should follow the API specification. |
| userId | string | yes | The user's primary email address. Use the special value `me` to refer to the authenticated user. |
No output schema declared.
No examples provided.
create_draft Create Draft ~297
Creates a new email draft with the DRAFT label in Gmail. The draft can optionally include classification labels and custom label IDs.
| Name | Type | Req | Description |
|---|---|---|---|
| classificationLabelValues | array | – | Classification label values to apply to the draft message. Each classification label ID must be unique; duplicate IDs will be deduplicated arbitrarily. Only available for Google Workspace accounts. |
| email_bcc | string | – | Blind carbon copy recipients (Bcc header), comma-separated |
| email_body | string | – | Email body content (plain text or HTML) |
| email_body_is_html | boolean | – | Whether email_body is HTML (True) or plain text (False) |
| email_cc | string | – | Carbon copy recipients (Cc header), comma-separated |
| email_from | string | – | Sender email address (From header) |
| email_in_reply_to | string | – | In-Reply-To header (Message-ID of original message) |
| email_references | string | – | References header (Message-IDs of related messages), space-separated |
| email_reply_to | string | – | Reply-To header address |
| email_subject | string | – | Email subject line |
| email_to | string | – | Recipient email address (To header) |
| labelIds | array | – | List of label IDs to apply to the draft message. Labels are applied in the order provided. |
| userId | string | yes | The user's email address or the special value 'me' to indicate the authenticated user. |
No output schema declared.
No examples provided.
create_label Create Label ~172
Creates a new custom label in Gmail for organizing messages and threads. Labels can be configured with specific visibility settings in the Gmail web interface.
| Name | Type | Req | Description |
|---|---|---|---|
| labelListVisibility | string | – | Controls whether this label appears in the label list in Gmail's web interface. |
| messageListVisibility | string | – | Controls whether messages with this label are visible in the message list in Gmail's web interface. |
| name | string | – | The display name for the label as it appears in Gmail. |
| type | string | – | The owner type for the label. User labels are created and managed by the user and can be applied to any message or thread. System labels are internally created and cannot be modified or deleted by us… |
| userId | string | yes | The user's email address or the special value `me` to indicate the authenticated user. |
No output schema declared.
No examples provided.
create_smime_config Create SMIME Config ~218
Upload and configure an S/MIME certificate for a send-as alias. The certificate must be provided in PKCS#12 format containing a private/public key pair and certificate chain.
| Name | Type | Req | Description |
|---|---|---|---|
| encryptedKeyPassword | string | – | Password for the encrypted private key, required if the PKCS#12 certificate is password-protected. |
| expiration | string | – | Certificate expiration timestamp in milliseconds since epoch (Unix time). |
| isDefault | boolean | – | Whether to set this S/MIME certificate as the default for this send-as address. |
| pkcs12 | string | – | The S/MIME certificate in PKCS#12 format. Must contain a single private/public key pair and certificate chain. The private key may be encrypted; if so, provide the password in encryptedKeyPassword. |
| sendAsEmail | string | yes | The email address that will appear in the From header for messages sent using this S/MIME alias. |
| userId | string | yes | The user's email address. Use the special value `me` to refer to the authenticated user. |
No output schema declared.
No examples provided.
delete_cse_identity Delete CSE Identity ~95
Permanently deletes a client-side encryption identity, preventing further use for sending encrypted messages. The identity cannot be restored; create a new identity with the same configuration if needed.
| Name | Type | Req | Description |
|---|---|---|---|
| cseEmailAddress | string | yes | The primary email address associated with the client-side encryption identity to be deleted. |
| userId | string | yes | The user's primary email address. Use the special value `me` to refer to the authenticated user. |
No output schema declared.
No examples provided.
delete_cse_keypair_permanently Delete CSE Keypair Permanently ~115
Permanently and immediately deletes a client-side encryption key pair. The key pair must be disabled for at least 30 days before obliteration. Once obliterated, all messages encrypted with this key become permanently inaccessible to all users.
| Name | Type | Req | Description |
|---|---|---|---|
| keyPairId | string | yes | The unique identifier of the key pair to permanently delete. |
| userId | string | yes | The email address of the user whose key pair will be obliterated. Use the special value `me` to refer to the authenticated user. |
No output schema declared.
No examples provided.
delete_draft Delete Draft ~77
Permanently deletes a draft message without moving it to trash. This action is immediate and irreversible.
| Name | Type | Req | Description |
|---|---|---|---|
| id | string | yes | The unique identifier of the draft message to delete. |
| userId | string | yes | The email address of the user whose draft should be deleted. Use the special value `me` to refer to the authenticated user. |
No output schema declared.
No examples provided.
delete_filter Delete Filter ~74
Permanently deletes a specified Gmail filter. This action is immediate and cannot be undone.
| Name | Type | Req | Description |
|---|---|---|---|
| id | string | yes | The unique identifier of the filter to be deleted. |
| userId | string | yes | The email address of the user whose filter will be deleted. Use the special value "me" to refer to the authenticated user. |
No output schema declared.
No examples provided.
delete_forwarding_address Delete Forwarding Address ~68
Deletes a forwarding address and revokes any associated verification. This operation requires service account credentials with domain-wide delegation authority.
| Name | Type | Req | Description |
|---|---|---|---|
| forwardingEmail | string | yes | The forwarding email address to delete. |
| userId | string | yes | The user's email address or 'me' to reference the authenticated user. |
No output schema declared.
No examples provided.
delete_label Delete Label ~73
Permanently deletes a label and removes it from all messages and threads it is applied to. This action cannot be undone.
| Name | Type | Req | Description |
|---|---|---|---|
| id | string | yes | The unique identifier of the label to delete. |
| userId | string | yes | The user's email address. Use the special value `me` to refer to the authenticated user. |
No output schema declared.
No examples provided.
delete_message Delete Message ~81
Permanently and immediately deletes a specified message. This action cannot be undone; consider using trash_message for recoverable deletion instead.
| Name | Type | Req | Description |
|---|---|---|---|
| id | string | yes | The unique identifier of the message to delete. |
| userId | string | yes | The email address of the user whose message will be deleted. Use the special value `me` to refer to the authenticated user. |
No output schema declared.
No examples provided.
delete_messages_batch Delete Messages Batch ~79
Permanently deletes multiple messages by their IDs. Note that this operation provides no guarantees about message existence or prior deletion status.
| Name | Type | Req | Description |
|---|---|---|---|
| ids | array | – | An array of message IDs to delete. The order of IDs is not significant. |
| userId | string | yes | The user's email address or the special value `me` to indicate the authenticated user. |
No output schema declared.
No examples provided.
delete_send_as_smime_config Delete Send As Smime Config ~113
Deletes the S/MIME configuration for a specified send-as alias. This removes the security certificate associated with the alias used for signing and encrypting outgoing emails.
| Name | Type | Req | Description |
|---|---|---|---|
| id | string | yes | The immutable identifier for the S/MIME configuration to delete. |
| sendAsEmail | string | yes | The email address that appears in the From header for messages sent using this send-as alias. |
| userId | string | yes | The user's email address. Use the special value `me` to refer to the authenticated user. |
No output schema declared.
No examples provided.
delete_thread Delete Thread ~82
Permanently deletes a thread and all messages within it. This action cannot be undone; consider using trash_thread as a safer alternative.
| Name | Type | Req | Description |
|---|---|---|---|
| id | string | yes | The unique identifier of the thread to delete. |
| userId | string | yes | The email address of the user whose thread will be deleted. Use the special value `me` to refer to the authenticated user. |
No output schema declared.
No examples provided.
disable_cse_keypair Disable CSE Keypair ~112
Disables a client-side encryption key pair, preventing the user from decrypting incoming CSE messages or signing outgoing CSE mail. The key pair can be re-enabled later using enable_cse_keypair, or permanently deleted after 30 days using obliterate_cse_keypair.
| Name | Type | Req | Description |
|---|---|---|---|
| keyPairId | string | yes | The unique identifier of the key pair to disable. |
| userId | string | yes | The user's primary email address. Use the special value 'me' to refer to the authenticated user. |
No output schema declared.
No examples provided.
enable_cse_keypair Enable CSE Keypair ~96
Reactivates a previously disabled client-side encryption key pair for use with associated encryption identities. Administrators require service account with domain-wide delegation authority; end users require hardware key encryption to be enabled.
| Name | Type | Req | Description |
|---|---|---|---|
| keyPairId | string | yes | The unique identifier of the key pair to reactivate. |
| userId | string | yes | The user's primary email address. Use the special value `me` to refer to the authenticated user. |
No output schema declared.
No examples provided.
get_auto_forwarding Get Auto Forwarding ~72
Retrieves the auto-forwarding configuration for the specified Gmail account. This includes the forwarding address and whether auto-forwarding is enabled.
| Name | Type | Req | Description |
|---|---|---|---|
| userId | string | yes | The Gmail account identifier. Use the email address associated with the account, or use the special value "me" to refer to the authenticated user's account. |
No output schema declared.
No examples provided.
get_cse_identity Get CSE Identity ~96
Retrieves a client-side encryption identity configuration for a specified email address. Administrators require service account with domain-wide delegation authority, while users require hardware key encryption to be enabled.
| Name | Type | Req | Description |
|---|---|---|---|
| cseEmailAddress | string | yes | The primary email address associated with the client-side encryption identity configuration to retrieve. |
| userId | string | yes | The requester's primary email address. Use the special value `me` to refer to the authenticated user. |
No output schema declared.
No examples provided.
get_cse_keypair Get CSE Keypair ~94
Retrieves a client-side encryption key pair for Gmail. Administrators require service account authorization with domain-wide delegation, while users must have hardware key encryption enabled.
| Name | Type | Req | Description |
|---|---|---|---|
| keyPairId | string | yes | The unique identifier of the encryption key pair to retrieve. |
| userId | string | yes | The email address of the user whose key pair is being retrieved. Use the special value `me` to refer to the authenticated user. |
No output schema declared.
No examples provided.
get_delegate Get Delegate ~107
Retrieves the delegate relationship for a specified email address. This operation requires service account clients with domain-wide authority and uses the delegate's primary email address (not aliases).
| Name | Type | Req | Description |
|---|---|---|---|
| delegateEmail | string | yes | The primary email address of the delegate whose relationship details should be retrieved. Email aliases cannot be used; the primary email address is required. |
| userId | string | yes | The email address of the user whose delegates are being queried. Use the special value 'me' to refer to the authenticated user. |
No output schema declared.
No examples provided.
get_draft Get Draft ~90
Retrieves a specific draft message by ID. Returns the draft in the requested format for viewing or further editing.
| Name | Type | Req | Description |
|---|---|---|---|
| format | string | – | The format in which to return the draft message content and metadata. |
| id | string | yes | The unique identifier of the draft message to retrieve. |
| userId | string | yes | The user's email address or the special value 'me' to refer to the authenticated user. |
No output schema declared.
No examples provided.
get_filter Get Filter ~75
Retrieves a specific Gmail filter by its ID. Use this to fetch the configuration and rules of an existing filter.
| Name | Type | Req | Description |
|---|---|---|---|
| id | string | yes | The unique identifier of the filter to retrieve. |
| userId | string | yes | The Gmail account identifier. Use 'me' to refer to the authenticated user, or provide the user's email address. |
No output schema declared.
No examples provided.
get_forwarding_address Get Forwarding Address ~90
Retrieves the configuration details for a specified forwarding address associated with a Gmail account. Use this to view forwarding settings for a particular email address.
| Name | Type | Req | Description |
|---|---|---|---|
| forwardingEmail | string | yes | The email address for which forwarding configuration should be retrieved. |
| userId | string | yes | The Gmail account identifier. Use the special value 'me' to refer to the authenticated user's account, or provide the user's full email address. |
No output schema declared.
No examples provided.
get_label Get Label ~79
Retrieves a specific Gmail label by its ID. Use this to fetch detailed information about a label, such as its name, visibility settings, and other metadata.
| Name | Type | Req | Description |
|---|---|---|---|
| id | string | yes | The unique identifier of the label to retrieve. |
| userId | string | yes | The user's email address or the special value `me` to refer to the authenticated user. |
No output schema declared.
No examples provided.
get_message Get Message ~145
Retrieves a specific message by ID from the user's mailbox. Supports multiple output formats including full message content, headers only, or raw RFC 2822 format.
| Name | Type | Req | Description |
|---|---|---|---|
| format | string | – | The format in which to return the message content and structure. |
| id | string | yes | The ID of the message to retrieve, typically obtained from messages.list, messages.insert, or messages.import operations. |
| metadataHeaders | array | – | When format is set to `metadata`, specify which message headers to include in the response. Headers should be provided as an array of header names. |
| userId | string | yes | The user's email address or the special value `me` to indicate the authenticated user. |
No output schema declared.
No examples provided.
get_message_attachment Get Message Attachment ~97
Retrieves a specific attachment from a Gmail message. Use this to download or access attachment metadata by providing the message ID and attachment ID.
| Name | Type | Req | Description |
|---|---|---|---|
| id | string | yes | The unique identifier of the attachment to retrieve. |
| messageId | string | yes | The unique identifier of the message containing the attachment. |
| userId | string | yes | The email address of the account owner. Use the special value `me` to refer to the authenticated user's account. |
No output schema declared.
No examples provided.
get_profile Get Profile ~53
Retrieves the Gmail profile information for the authenticated user or a specified user, including account details and settings.
| Name | Type | Req | Description |
|---|---|---|---|
| userId | string | yes | The user's email address or the special value `me` to refer to the authenticated user. |
No output schema declared.
No examples provided.
get_send_as_alias Get Send As Alias ~86
Retrieves a specific send-as alias configuration for a user. Returns an HTTP 404 error if the specified email address is not configured as a send-as alias.
| Name | Type | Req | Description |
|---|---|---|---|
| sendAsEmail | string | yes | The email address of the send-as alias to retrieve. |
| userId | string | yes | The user's email address. Use the special value 'me' to refer to the authenticated user. |
No output schema declared.
No examples provided.
get_smime_info Get Smime Info ~111
Retrieves the S/MIME configuration for a specified send-as alias. This allows you to access the details of a specific S/MIME certificate associated with an email alias.
| Name | Type | Req | Description |
|---|---|---|---|
| id | string | yes | The immutable identifier for the S/MIME configuration. |
| sendAsEmail | string | yes | The email address that appears in the From header for messages sent using this send-as alias. |
| userId | string | yes | The user's email address. Use the special value `me` to refer to the authenticated user. |
No output schema declared.
No examples provided.
get_thread Get Thread ~138
Retrieves a specific email thread by ID. Returns thread messages in the requested format with optional filtering of metadata headers.
| Name | Type | Req | Description |
|---|---|---|---|
| format | string | – | The format in which to return thread messages. Controls the level of detail included in the response. |
| id | string | yes | The unique identifier of the thread to retrieve. |
| metadataHeaders | array | – | When format is set to metadata, specify which email headers to include in the response. Headers should be provided as an array of header names. |
| userId | string | yes | The email address of the user whose thread should be retrieved. Use the special value `me` to refer to the authenticated user. |
No output schema declared.
No examples provided.
get_vacation_settings Get Vacation Settings ~64
Retrieves the vacation responder settings for a Gmail account, including whether auto-reply is enabled and the message content.
| Name | Type | Req | Description |
|---|---|---|---|
| userId | string | yes | The Gmail user account identifier. Use 'me' to refer to the authenticated user, or provide a specific email address. |
No output schema declared.
No examples provided.
import_message Import Message ~418
Imports a message into the user's mailbox with standard email delivery scanning and classification. The message is processed similarly to SMTP delivery, with a maximum size limit of 150MB.
| Name | Type | Req | Description |
|---|---|---|---|
| classificationLabelValues | array | – | Classification label values to apply to the message. Each classification label ID must be unique; duplicate IDs will be deduplicated arbitrarily. Only applicable for Google Workspace accounts. Availa… |
| deleted | boolean | – | Mark the message as permanently deleted and only visible to Google Vault administrators. Only applicable for Google Workspace accounts. |
| email_bcc | string | – | Blind carbon copy recipients (Bcc header), comma-separated |
| email_body | string | – | Email body content (plain text or HTML) |
| email_body_is_html | boolean | – | Whether email_body is HTML (True) or plain text (False) |
| email_cc | string | – | Carbon copy recipients (Cc header), comma-separated |
| email_from | string | – | Sender email address (From header) |
| email_in_reply_to | string | – | In-Reply-To header (Message-ID of original message) |
| email_references | string | – | References header (Message-IDs of related messages), space-separated |
| email_reply_to | string | – | Reply-To header address |
| email_subject | string | – | Email subject line |
| email_to | string | – | Recipient email address (To header) |
| internalDateSource | string | – | Determines the source for Gmail's internal date assignment to the message. |
| labelIds | array | – | List of label IDs to apply to the imported message. Labels are applied in the order provided. |
| neverMarkSpam | boolean | – | Prevent Gmail's spam classifier from marking this message as SPAM, regardless of its classification decision. |
| processForCalendar | boolean | – | Automatically process calendar invitations in the message and add any extracted meetings to the user's Google Calendar. |
| userId | string | yes | The user's email address. Use the special value 'me' to reference the authenticated user. |
No output schema declared.
No examples provided.
insert_message Insert Message ~370
Inserts a message directly into the user's mailbox, bypassing scanning and classification, similar to IMAP APPEND. This operation does not send a message but adds it to the mailbox with optional metadata.
| Name | Type | Req | Description |
|---|---|---|---|
| classificationLabelValues | array | – | Classification label values to apply to the message. Each classification label ID must be unique; duplicate IDs will be deduplicated arbitrarily. Only applicable for Google Workspace accounts. Availa… |
| deleted | boolean | – | Mark the message as permanently deleted and only visible to Google Vault administrators. Only applicable for Google Workspace accounts. |
| email_bcc | string | – | Blind carbon copy recipients (Bcc header), comma-separated |
| email_body | string | – | Email body content (plain text or HTML) |
| email_body_is_html | boolean | – | Whether email_body is HTML (True) or plain text (False) |
| email_cc | string | – | Carbon copy recipients (Cc header), comma-separated |
| email_from | string | – | Sender email address (From header) |
| email_in_reply_to | string | – | In-Reply-To header (Message-ID of original message) |
| email_references | string | – | References header (Message-IDs of related messages), space-separated |
| email_reply_to | string | – | Reply-To header address |
| email_subject | string | – | Email subject line |
| email_to | string | – | Recipient email address (To header) |
| internalDateSource | string | – | Determines the source for Gmail's internal date assigned to the message. |
| labelIds | array | – | List of label IDs to apply to this message. Labels are applied in the order provided. |
| userId | string | yes | The user's email address. Use the special value 'me' to refer to the authenticated user. |
No output schema declared.
No examples provided.
list_cse_identities List CSE Identities ~102
Retrieves all client-side encrypted identities for an authenticated user. Administrators with domain-wide delegation can manage identities for their organization, while users managing their own identities require hardware key encryption to be enabled.
| Name | Type | Req | Description |
|---|---|---|---|
| pageSize | integer | – | Maximum number of identities to return per page. If not specified, defaults to 20 entries. |
| userId | string | yes | The user's primary email address. Use the special value `me` to refer to the authenticated user. |
No output schema declared.
No examples provided.
list_cse_keypairs List CSE Keypairs ~103
Retrieves all client-side encryption key pairs for a user. Administrators with domain-wide delegation can manage keypairs for users in their organization, while individual users require hardware key encryption to be enabled.
| Name | Type | Req | Description |
|---|---|---|---|
| pageSize | integer | – | Maximum number of key pairs to return per page. If not specified, defaults to 20 entries. |
| userId | string | yes | The user's primary email address. Use the special value `me` to refer to the authenticated user. |
No output schema declared.
No examples provided.
list_delegates List Delegates ~68
Retrieves the list of delegates for the specified Gmail account. This operation requires service account credentials with domain-wide delegation authority.
| Name | Type | Req | Description |
|---|---|---|---|
| userId | string | yes | The Gmail user account identifier. Use the special value 'me' to refer to the authenticated user, or provide the user's full email address. |
No output schema declared.
No examples provided.
list_drafts List Drafts ~157
Retrieves a list of draft messages from the user's mailbox. Supports filtering by search query and optional inclusion of drafts from spam and trash folders.
| Name | Type | Req | Description |
|---|---|---|---|
| includeSpamTrash | boolean | – | Whether to include draft messages from the SPAM and TRASH folders in the results. |
| maxResults | integer | – | Maximum number of drafts to return. The default is 100 and the maximum allowed value is 500. |
| q | string | – | Filter draft messages using Gmail search query syntax. Supports the same query operators as the Gmail search box (e.g., from:, rfc822msgid:, is:unread). |
| userId | string | yes | The user's email address. Use the special value `me` to refer to the authenticated user. |
No output schema declared.
No examples provided.
list_filters List Filters ~66
Retrieves all message filters configured for a Gmail account. Filters define rules for automatically organizing, labeling, or processing incoming messages.
| Name | Type | Req | Description |
|---|---|---|---|
| userId | string | yes | The Gmail user account identifier. Use the special value 'me' to refer to the authenticated user, or provide a specific email address. |
No output schema declared.
No examples provided.
list_forwarding_addresses List Forwarding Addresses ~68
Retrieves all forwarding addresses configured for the specified Gmail account. Forwarding addresses are alternative email addresses where incoming messages can be automatically sent.
| Name | Type | Req | Description |
|---|---|---|---|
| userId | string | yes | The Gmail account identifier. Use the authenticated user's email address, or specify 'me' to refer to the currently authenticated user. |
No output schema declared.
No examples provided.
list_labels List Labels ~52
Retrieves all labels in the user's mailbox. Labels are used to organize and categorize emails in Gmail.
| Name | Type | Req | Description |
|---|---|---|---|
| userId | string | yes | The user's email address or the special value `me` to refer to the authenticated user. |
No output schema declared.
No examples provided.
list_mailbox_history List Mailbox History ~219
Retrieves the chronological history of all changes to a mailbox, including message additions, deletions, and label modifications. Results are returned in chronological order by historyId and support pagination for efficient sync operations.
| Name | Type | Req | Description |
|---|---|---|---|
| historyTypes | array | – | Types of history events to include in results. When specified, only changes matching these types are returned. |
| labelId | string | – | Filter results to only include messages with a specific label ID. |
| maxResults | integer | – | Maximum number of history records to return per request. Defaults to 100 if not specified. |
| startHistoryId | string | – | Starting point for retrieving history records. Provide a historyId from a previous response or message to retrieve all changes after that point. History IDs are valid for at least a week but may expi… |
| userId | string | yes | The user's email address. Use the special value `me` to refer to the authenticated user. |
No output schema declared.
No examples provided.
list_messages List Messages ~306
Retrieves a list of messages from the user's mailbox, with optional filtering by labels and inclusion of spam/trash folders. Supports pagination through the maxResults parameter.
| Name | Type | Req | Description |
|---|---|---|---|
| after_date | string | – | Filter messages after this date (YYYY/MM/DD format) |
| before_date | string | – | Filter messages before this date (YYYY/MM/DD format) |
| custom_query | string | – | Custom Gmail query string for advanced filters (e.g., 'rfc822msgid:<id>') |
| from_address | string | – | Filter messages from a specific sender email address |
| has_attachment | boolean | – | Filter messages that have attachments |
| includeSpamTrash | boolean | – | Include messages from SPAM and TRASH folders in the results. Defaults to false if not specified. |
| is_starred | boolean | – | Filter starred messages only |
| is_unread | boolean | – | Filter unread messages only |
| labelIds | array | – | Filter results to only include messages with labels matching all specified label IDs. Messages within the same thread may have different labels. Provide as an array of label ID strings. |
| maxResults | integer | – | Maximum number of messages to return per request. Defaults to 100 if not specified. |
| subject_contains | string | – | Filter messages with subject containing this text |
| to_address | string | – | Filter messages to a specific recipient email address |
| userId | string | yes | The user's email address. Use the special value `me` to refer to the authenticated user. |
No output schema declared.
No examples provided.
list_send_as_aliases List Send As Aliases ~59
Retrieves all send-as aliases configured for the specified Gmail account, including the primary email address and any custom 'from' aliases.
| Name | Type | Req | Description |
|---|---|---|---|
| userId | string | yes | The Gmail account identifier. Use 'me' to reference the authenticated user's account. |
No output schema declared.
No examples provided.
list_smime_configs List Smime Configs ~102
Lists all S/MIME configurations for a specified send-as alias. S/MIME configs define the certificates and encryption settings used when sending emails from this alias.
| Name | Type | Req | Description |
|---|---|---|---|
| sendAsEmail | string | yes | The email address configured as a send-as alias. This is the address that appears in the From header for emails sent using this alias. |
| userId | string | yes | The user's email address. Use the special value `me` to refer to the authenticated user. |
No output schema declared.
No examples provided.
list_threads List Threads ~168
Retrieves a list of message threads from the user's mailbox, with optional filtering by labels, search query, and inclusion of spam/trash folders.
| Name | Type | Req | Description |
|---|---|---|---|
| includeSpamTrash | boolean | – | Include threads from the SPAM and TRASH folders in the results. |
| labelIds | array | – | Filter results to only return threads that have all of the specified label IDs. Provide as an array of label ID strings. |
| maxResults | integer | – | Maximum number of threads to return in the response. |
| q | string | – | Filter results using Gmail search query syntax (e.g., sender, subject, date filters, read status). Not supported when using the gmail.metadata scope. |
| userId | string | yes | The user's email address. Use the special value `me` to refer to the authenticated user. |
No output schema declared.
No examples provided.
move_message_to_trash Move Message to Trash ~72
Moves a specified message to the trash folder. The message can be restored from trash before permanent deletion.
| Name | Type | Req | Description |
|---|---|---|---|
| id | string | yes | The unique identifier of the message to move to trash. |
| userId | string | yes | The user's email address or the special value `me` to reference the authenticated user. |
No output schema declared.
No examples provided.
move_thread_to_trash Move Thread to Trash ~78
Moves a thread and all its associated messages to the trash. The thread and its messages can be permanently deleted or recovered from trash.
| Name | Type | Req | Description |
|---|---|---|---|
| id | string | yes | The unique identifier of the thread to move to trash. |
| userId | string | yes | The user's email address or the special value 'me' to reference the authenticated user. |
No output schema declared.
No examples provided.
remove_message_from_trash Remove Message From Trash ~88
Restores a message from the trash by removing it from the trash folder. The message will be returned to its previous labels or inbox.
| Name | Type | Req | Description |
|---|---|---|---|
| id | string | yes | The unique identifier of the message to restore from trash. |
| userId | string | yes | The email address of the user whose message should be restored. Use the special value `me` to refer to the authenticated user. |
No output schema declared.
No examples provided.
remove_thread_from_trash Remove Thread From Trash ~73
Restores a thread from trash by removing it and all its associated messages from the trash folder.
| Name | Type | Req | Description |
|---|---|---|---|
| id | string | yes | The unique identifier of the thread to restore from trash. |
| userId | string | yes | The user's email address. Use the special value `me` to refer to the authenticated user. |
No output schema declared.
No examples provided.
What is the com.mcparmory/google-gmail MCP server?
com.mcparmory/google-gmail is an MCP server listed in the public MCP registry as com.mcparmory/google-gmail. Send, read, organize emails, manage labels, drafts, and filters. This page covers its PyPI package (mcparmory-google-gmail).
Is the com.mcparmory/google-gmail MCP server safe to use?
com.mcparmory/google-gmail scores 61 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 20 September 2026. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.
What tools does the com.mcparmory/google-gmail MCP server expose?
com.mcparmory/google-gmail exposes 63 tools: get_profile, list_drafts, create_draft, get_draft, update_draft, and 58 more. Their descriptions and schemas cost roughly 8,935 tokens of context every time the server is loaded.
Is the com.mcparmory/google-gmail MCP server still maintained?
com.mcparmory/google-gmail is still listed as active in the MCP registry. We last reached this channel on 20 September 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.