---
title: "Gmail Search"
description: "Local-first visual environment for building and running AI workflows. Build agents visually, deploy anywhere, privacy by design."
canonical: https://docs.nodetool.ai/nodes/lib/google/gmailsearch
markdown: https://docs.nodetool.ai/nodes/lib/google/gmailsearch.md
product: NodeTool
source: https://github.com/nodetool-ai/nodetool/blob/main/docs/nodes/lib/google/gmailsearch.md
---

# Gmail Search

**Type:** `lib.google.GmailSearch`

**Namespace:** `lib.google`

## Description

Search Gmail with Gmail query syntax and return parsed messages.
    google, gmail, email, search, inbox

## Properties

| Property | Type | Description | Default |
|----------|------|-------------|---------|
| query | `str` | Gmail query, e.g. 'from:alice@example.com newer_than:7d' | `` |
| max_results | `int` | Maximum number of messages to return | `10` |

## Outputs

| Output | Type | Description |
|--------|------|-------------|
| output | `dict` |  |
| outputs | `list` |  |

## Related Nodes

Browse other nodes in the [lib.google](./) namespace.