Gmail

Gmail is Google’s cloud based email service that allows you to access your messages from any computer or device with just a web browser.

Supports authentication: OAuth 2.0

Tool list

gmail_fetch_mails

Fetch emails from a connected Gmail account using search filters. Requires a valid Gmail OAuth2 connection.

Name	Type	Required	Description
format	string	No	Format of the returned message.
include_spam_trash	boolean	No	Whether to fetch emails from spam and trash folders
label_ids	array<string>	No	Gmail label IDs to filter messages
max_results	integer	No	Maximum number of emails to fetch
page_token	string	No	Page token for pagination
query	string	No	Search query string using Gmail’s search syntax (e.g., ‘is:unread from:user@example.com’)
schema_version	string	No	Optional schema version to use for tool execution
tool_version	string	No	Optional tool version to use for execution

gmail_get_attachment_by_id

Retrieve a specific attachment from a Gmail message using the message ID and attachment ID.

Name	Type	Required	Description
attachment_id	string	Yes	Unique Gmail attachment ID
file_name	string	No	Preferred filename to use when saving/returning the attachment
message_id	string	Yes	Unique Gmail message ID that contains the attachment
schema_version	string	No	Optional schema version to use for tool execution
tool_version	string	No	Optional tool version to use for execution

gmail_get_contacts

Fetch a list of contacts from the connected Gmail account. Supports pagination and field filtering.

Name	Type	Required	Description
max_results	integer	No	Maximum number of contacts to fetch
page_token	string	No	Token to retrieve the next page of results
person_fields	array<string>	No	Fields to include for each person
schema_version	string	No	Optional schema version to use for tool execution
tool_version	string	No	Optional tool version to use for execution

gmail_get_message_by_id

Retrieve a specific Gmail message using its message ID. Optionally control the format of the returned data.

Name	Type	Required	Description
format	string	No	Format of the returned message.
message_id	string	Yes	Unique Gmail message ID
schema_version	string	No	Optional schema version to use for tool execution
tool_version	string	No	Optional tool version to use for execution

gmail_list_drafts

List draft emails from a connected Gmail account. Requires a valid Gmail OAuth2 connection.

Name	Type	Required	Description
max_results	integer	No	Maximum number of drafts to fetch
page_token	string	No	Page token for pagination
schema_version	string	No	Optional schema version to use for tool execution
tool_version	string	No	Optional tool version to use for execution

gmail_search_people

Search people or contacts in the connected Google account using a query. Requires a valid Google OAuth2 connection with People API scopes.

Name	Type	Required	Description
other_contacts	boolean	No	Whether to include people not in the user’s contacts (from ‘Other Contacts’).
page_size	integer	No	Maximum number of people to return.
person_fields	array<string>	No	Fields to retrieve for each person.
query	string	Yes	Text query to search people (e.g., name, email address).
schema_version	string	No	Optional schema version to use for tool execution
tool_version	string	No	Optional tool version to use for execution