> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zocomputer.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Use Gmail

> Work with the user's connected Gmail account.

{/* Tool: use_app_gmail */}

## Parameters

<ParamField path="tool_name" type="string" required={true}>
  Exact tool name returned by `list_app_tools`, including the Hostagent-native `gmail-get-message` action.
</ParamField>

<ParamField path="configured_props" type="object" required={true}>
  The configured props for the action (e.g., `{"to": "team@zocomputer.com", "subject": "Subject", "body": "Body"}`)
</ParamField>

<ParamField path="download_path" type="string" default={""}>
  Optional absolute path for the original message. `gmail-get-message` defaults to `/home/workspace/gmail-&lt;messageId&gt;.eml`; readable artifacts use the same basename.
</ParamField>

<ParamField path="email" type="string" default={""}>
  Optional email address to select a specific connected account.
</ParamField>