Gmail

Service domainEMAIL

Arcade Optimized

Arcade.dev LLM tools for Gmail

Author:Arcade

Version:4.2.0

Auth:User authorization via the Google auth provider

18tools

Arcade.dev's Gmail toolkit enables seamless integration with the Gmail API, allowing developers to manage emails and labels effectively within their applications.

Capabilities

Manage email threads and labels.
Compose, send, and manage drafts.
Retrieve detailed user profile information.
Support for email searching and filtering.
Efficiently handle email status changes such as trashing.

OAuth

Provider: Google
Scopes: Access to read, compose, modify, and send Gmail emails, alongside user profile information.

Secrets

No secret types required for toolkit operation.

Available tools(18)

18 of 18 tools

Operations

Behavior

	Tool name	Description	Secrets
	Gmail.ChangeEmailLabels	Add and remove labels from an email using the Gmail API.
	Gmail.CreateLabel	Create a new label in the user's mailbox.
	Gmail.DeleteDraftEmail	Delete a draft email using the Gmail API.
	Gmail.GetThread	Get the specified thread by ID.
	Gmail.ListDraftEmails	Lists draft emails in the user's draft mailbox using the Gmail API.
	Gmail.ListEmails	Read emails from a Gmail account and extract plain text content.
	Gmail.ListEmailsByHeader	Search for emails by header using the Gmail API.
	Gmail.ListLabels	List all the labels in the user's mailbox.
	Gmail.ListThreads	List threads in the user's mailbox.
	Gmail.ReplyToEmail	Send a reply to an email message.
	Gmail.SearchThreads	Search for threads in the user's mailbox
	Gmail.SendDraftEmail	Send a draft email using the Gmail API.
	Gmail.SendEmail	Send an email using the Gmail API.
	Gmail.TrashEmail	Move an email to the trash folder using the Gmail API.
	Gmail.UpdateDraftEmail	Update an existing email draft using the Gmail API.
	Gmail.WhoAmI	Get comprehensive user profile and Gmail account information. This tool provides detailed information about the authenticated user including their name, email, profile picture, Gmail account statistics, and other important profile details from Google services.
	Gmail.WriteDraftEmail	Compose a new email draft using the Gmail API.
	Gmail.WriteDraftReplyEmail	Compose a draft reply to an email message.

Selected tools

No tools selected.

Click "Show all tools" to add tools.

Requirements

Select tools to see requirements

Gmail.ChangeEmailLabels

Add to selected tools

Execution hints

Signals for MCP clients and agents about how this tool behaves.

Operations

Update

Service domains

MCP behavior

Read only

Does not modify remote state.

Destructive

May delete or overwrite remote data.

Idempotent

Yes

Safe to retry without extra side effects.

Open world

Yes

Can call out to external systems.

Add and remove labels from an email using the Gmail API.

Parameters

Parameter	Type	Req.	Description
`email_id`	`string`	Required	The ID of the email to modify labels for
`labels_to_add`	`array<string>`	Required	List of label names to add
`labels_to_remove`	`array<string>`	Required	List of label names to remove

Requirements

No secrets required

Output

Type:json— Confirmation with labels that were added and removed

Gmail.CreateLabel

Add to selected tools

Execution hints

Signals for MCP clients and agents about how this tool behaves.

Operations

Create

Service domains

MCP behavior

Read only

Does not modify remote state.

Destructive

May delete or overwrite remote data.

Idempotent

Safe to retry without extra side effects.

Open world

Yes

Can call out to external systems.

Create a new label in the user's mailbox.

Parameters

Parameter	Type	Req.	Description
`label_name`	`string`	Required	The name of the label to create

Requirements

No secrets required

Output

Type:json— The created label wrapped in label key

Gmail.DeleteDraftEmail

Add to selected tools

Execution hints

Signals for MCP clients and agents about how this tool behaves.

Operations

Delete

Service domains

MCP behavior

Read only

Does not modify remote state.

Destructive

Yes

May delete or overwrite remote data.

Idempotent

Yes

Safe to retry without extra side effects.

Open world

Yes

Can call out to external systems.

Delete a draft email using the Gmail API.

Parameters

Parameter	Type	Req.	Description
`draft_email_id`	`string`	Required	The ID of the draft email to delete

Requirements

No secrets required

Output

Type:string— A confirmation message indicating successful deletion

Gmail.GetThread

Add to selected tools

Execution hints

Signals for MCP clients and agents about how this tool behaves.

Operations

Read

Service domains

MCP behavior

Read only

Yes

Does not modify remote state.

Destructive

May delete or overwrite remote data.

Idempotent

Yes

Safe to retry without extra side effects.

Open world

Yes

Can call out to external systems.

Get the specified thread by ID.

Parameters

Parameter	Type	Req.	Description
`thread_id`	`string`	Required	The ID of the thread to retrieve

Requirements

No secrets required

Output

Type:json— A dictionary containing the thread details with dates in descriptive UTC format

Gmail.ListDraftEmails

Add to selected tools

Execution hints

Signals for MCP clients and agents about how this tool behaves.

Operations

Read

Service domains

MCP behavior

Read only

Yes

Does not modify remote state.

Destructive

May delete or overwrite remote data.

Idempotent

Yes

Safe to retry without extra side effects.

Open world

Yes

Can call out to external systems.

Lists draft emails in the user's draft mailbox using the Gmail API.

Parameters

Parameter	Type	Req.	Description
`n_drafts`	`integer`	Optional	Number of draft emails to read (Min 1, Max 100)

Requirements

No secrets required

Output

Type:json— A dictionary containing a list of draft email details with dates in descriptive UTC format

Gmail.ListEmails

Add to selected tools

Execution hints

Signals for MCP clients and agents about how this tool behaves.

Operations

Read

Service domains

MCP behavior

Read only

Yes

Does not modify remote state.

Destructive

May delete or overwrite remote data.

Idempotent

Yes

Safe to retry without extra side effects.

Open world

Yes

Can call out to external systems.

Read emails from a Gmail account and extract plain text content.

Parameters

Parameter	Type	Req.	Description
`n_emails`	`integer`	Optional	Number of emails to read (Min 1, Max 100)

Requirements

No secrets required

Output

Type:json— A dictionary containing a list of email details with dates in descriptive UTC format

Gmail.ListEmailsByHeader

Add to selected tools

Execution hints

Signals for MCP clients and agents about how this tool behaves.

Operations

Read

Service domains

MCP behavior

Read only

Yes

Does not modify remote state.

Destructive

May delete or overwrite remote data.

Idempotent

Yes

Safe to retry without extra side effects.

Open world

Yes

Can call out to external systems.

Search for emails by header using the Gmail API.

Parameters

Parameter	Type	Req.	Description
`sender`	`string`	Optional	The name or email address of the sender of the email
`recipient`	`string`	Optional	The name or email address of the recipient
`subject`	`string`	Optional	Words to find in the subject of the email
`body`	`string`	Optional	Words to find in the body of the email
`date_range`	`string`	Optional	The date range of the email `todayyesterdaylast_7_dayslast_30_daysthis_monthlast_monththis_year`
`label`	`string`	Optional	The label name to filter by
`max_results`	`integer`	Optional	The maximum number of emails to return (Min 1, Max 100

Requirements

No secrets required

Output

Type:json— A dictionary containing a list of email details with dates in descriptive UTC format

Gmail.ListLabels

Add to selected tools

Execution hints

Signals for MCP clients and agents about how this tool behaves.

Operations

Read

Service domains

MCP behavior

Read only

Yes

Does not modify remote state.

Destructive

May delete or overwrite remote data.

Idempotent

Yes

Safe to retry without extra side effects.

Open world

Yes

Can call out to external systems.

List all the labels in the user's mailbox.

Parameters

No parameters required.

Requirements

No secrets required

Output

Type:json— A dictionary containing a list of label details

Gmail.ListThreads

Add to selected tools

Execution hints

Signals for MCP clients and agents about how this tool behaves.

Operations

Read

Service domains

MCP behavior

Read only

Yes

Does not modify remote state.

Destructive

May delete or overwrite remote data.

Idempotent

Yes

Safe to retry without extra side effects.

Open world

Yes

Can call out to external systems.

List threads in the user's mailbox.

Parameters

Parameter	Type	Req.	Description
`page_token`	`string`	Optional	Page token to retrieve a specific page of results in the list
`max_results`	`integer`	Optional	The maximum number of threads to return (Min {MIN_RESULTS}, Max {MAX_RESULTS})
`include_spam_trash`	`boolean`	Optional	Whether to include spam and trash in the results

Requirements

No secrets required

Output

Type:json— A dictionary containing a list of thread details

Gmail.ReplyToEmail

Add to selected tools

Execution hints

Signals for MCP clients and agents about how this tool behaves.

Operations

Create

Service domains

MCP behavior

Read only

Does not modify remote state.

Destructive

May delete or overwrite remote data.

Idempotent

Safe to retry without extra side effects.

Open world

Yes

Can call out to external systems.

Send a reply to an email message.

Parameters

Parameter	Type	Req.	Description
`body`	`string`	Required	The body of the email
`reply_to_message_id`	`string`	Required	The ID of the message to reply to
`reply_to_whom`	`string`	Optional	Whether to reply to every recipient (including cc) or only to the original sender. Defaults to 'GmailReplyToWhom.ONLY_THE_SENDER'. `every_recipientonly_the_sender`
`bcc`	`array<string>`	Optional	BCC recipients of the email
`content_type`	`string`	Optional	The content type of the email body. Defaults to 'plain' `plainhtml`

Requirements

No secrets required

Output

Type:json— A dictionary containing the sent email details with date in descriptive UTC format

Gmail.SearchThreads

Add to selected tools

Execution hints

Signals for MCP clients and agents about how this tool behaves.

Operations

Read

Service domains

MCP behavior

Read only

Yes

Does not modify remote state.

Destructive

May delete or overwrite remote data.

Idempotent

Yes

Safe to retry without extra side effects.

Open world

Yes

Can call out to external systems.

Search for threads in the user's mailbox

Parameters

Parameter	Type	Req.	Description
`page_token`	`string`	Optional	Page token to retrieve a specific page of results in the list
`max_results`	`integer`	Optional	The maximum number of threads to return (Min {MIN_RESULTS}, Max {MAX_RESULTS})
`include_spam_trash`	`boolean`	Optional	Whether to include spam and trash in the results
`label_ids`	`array<string>`	Optional	The IDs of labels to filter by
`sender`	`string`	Optional	The name or email address of the sender of the email
`recipient`	`string`	Optional	The name or email address of the recipient
`subject`	`string`	Optional	Words to find in the subject of the email
`body`	`string`	Optional	Words to find in the body of the email
`date_range`	`string`	Optional	The date range of the email `todayyesterdaylast_7_dayslast_30_daysthis_monthlast_monththis_year`

Requirements

No secrets required

Output

Type:json— A dictionary containing a list of thread details

Gmail.SendDraftEmail

Add to selected tools

Execution hints

Signals for MCP clients and agents about how this tool behaves.

Operations

Create

Service domains

MCP behavior

Read only

Does not modify remote state.

Destructive

May delete or overwrite remote data.

Idempotent

Safe to retry without extra side effects.

Open world

Yes

Can call out to external systems.

Send a draft email using the Gmail API.

Parameters

Parameter	Type	Req.	Description
`email_id`	`string`	Required	The ID of the draft to send

Requirements

No secrets required

Output

Type:json— A dictionary containing the sent email details with date in descriptive UTC format

Gmail.SendEmail

Add to selected tools

Execution hints

Signals for MCP clients and agents about how this tool behaves.

Operations

Create

Service domains

MCP behavior

Read only

Does not modify remote state.

Destructive

May delete or overwrite remote data.

Idempotent

Safe to retry without extra side effects.

Open world

Yes

Can call out to external systems.

Send an email using the Gmail API.

Parameters

Parameter	Type	Req.	Description
`subject`	`string`	Required	The subject of the email
`body`	`string`	Required	The body of the email
`recipient`	`string`	Required	The recipient of the email
`cc`	`array<string>`	Optional	CC recipients of the email
`bcc`	`array<string>`	Optional	BCC recipients of the email
`content_type`	`string`	Optional	The content type of the email body. Defaults to 'plain' `plainhtml`

Requirements

No secrets required

Output

Type:json— A dictionary containing the sent email details with date in descriptive UTC format

Gmail.TrashEmail

Add to selected tools

Execution hints

Signals for MCP clients and agents about how this tool behaves.

Operations

Delete

Service domains

MCP behavior

Read only

Does not modify remote state.

Destructive

Yes

May delete or overwrite remote data.

Idempotent

Yes

Safe to retry without extra side effects.

Open world

Yes

Can call out to external systems.

Move an email to the trash folder using the Gmail API.

Parameters

Parameter	Type	Req.	Description
`email_id`	`string`	Required	The ID of the email to trash

Requirements

No secrets required

Output

Type:json— Details of the trashed email with URL to view in Gmail trash folder

Gmail.UpdateDraftEmail

Add to selected tools

Execution hints

Signals for MCP clients and agents about how this tool behaves.

Operations

Update

Service domains

MCP behavior

Read only

Does not modify remote state.

Destructive

May delete or overwrite remote data.

Idempotent

Yes

Safe to retry without extra side effects.

Open world

Yes

Can call out to external systems.

Update an existing email draft using the Gmail API.

Parameters

Parameter	Type	Req.	Description
`draft_email_id`	`string`	Required	The ID of the draft email to update.
`subject`	`string`	Required	The subject of the draft email
`body`	`string`	Required	The body of the draft email
`recipient`	`string`	Required	The recipient of the draft email
`cc`	`array<string>`	Optional	CC recipients of the draft email
`bcc`	`array<string>`	Optional	BCC recipients of the draft email

Requirements

No secrets required

Output

Type:json— A dictionary containing the updated draft email details with date in descriptive UTC format

Gmail.WhoAmI

Add to selected tools

Execution hints

Signals for MCP clients and agents about how this tool behaves.

Operations

Read

Service domains

MCP behavior

Read only

Yes

Does not modify remote state.

Destructive

May delete or overwrite remote data.

Idempotent

Yes

Safe to retry without extra side effects.

Open world

Yes

Can call out to external systems.

Get comprehensive user profile and Gmail account information. This tool provides detailed information about the authenticated user including their name, email, profile picture, Gmail account statistics, and other important profile details from Google services.

Parameters

No parameters required.

Requirements

No secrets required

Output

Type:json— Get comprehensive user profile and Gmail account information.

Gmail.WriteDraftEmail

Add to selected tools

Execution hints

Signals for MCP clients and agents about how this tool behaves.

Operations

Create

Service domains

MCP behavior

Read only

Does not modify remote state.

Destructive

May delete or overwrite remote data.

Idempotent

Safe to retry without extra side effects.

Open world

Yes

Can call out to external systems.

Compose a new email draft using the Gmail API.

Parameters

Parameter	Type	Req.	Description
`subject`	`string`	Required	The subject of the draft email
`body`	`string`	Required	The body of the draft email
`recipient`	`string`	Required	The recipient of the draft email
`cc`	`array<string>`	Optional	CC recipients of the draft email
`bcc`	`array<string>`	Optional	BCC recipients of the draft email
`content_type`	`string`	Optional	The content type of the email body. Defaults to 'plain' `plainhtml`

Requirements

No secrets required

Output

Type:json— A dictionary containing the created draft email details with date in descriptive UTC format

Gmail.WriteDraftReplyEmail

Add to selected tools

Execution hints

Signals for MCP clients and agents about how this tool behaves.

Operations

Create

Service domains

MCP behavior

Read only

Does not modify remote state.

Destructive

May delete or overwrite remote data.

Idempotent

Safe to retry without extra side effects.

Open world

Yes

Can call out to external systems.

Compose a draft reply to an email message.

Parameters

Parameter	Type	Req.	Description
`body`	`string`	Required	The body of the draft reply email
`reply_to_message_id`	`string`	Required	The Gmail message ID of the message to draft a reply to
`reply_to_whom`	`string`	Optional	Whether to reply to every recipient (including cc) or only to the original sender. Defaults to 'GmailReplyToWhom.ONLY_THE_SENDER'. `every_recipientonly_the_sender`
`bcc`	`array<string>`	Optional	BCC recipients of the draft reply email
`content_type`	`string`	Optional	The content type of the email body. Defaults to 'plain' `plainhtml`

Requirements

No secrets required

Output

Type:json— A dictionary containing draft reply email details with dates in descriptive UTC format

Get Building

Use tools hosted on Arcade Cloud

Arcade tools are hosted by our cloud platform and ready to be used in your agents. Learn how.

Learn more

Self Host Arcade tools

Arcade tools can be self-hosted on your own infrastructure. Learn more about self-hosting.

pip install arcade_gmail

Learn more