Tools · Services

gmail_search

Read-only

Search, read, draft, and send Gmail messages from a configured Google account.

When to use: Use this for inbox search, message lookup, labels, drafts, sending email, and Gmail thread context.

Example

The call

tool call

{
  "tool": "gmail_search",
  "arguments": {
    "action": "search",
    "query": "from:[email protected] newer_than:7d"
  }
}

Needs a connected Google account

So it isn't run here, and no output is shown: nothing on this page is made up.

Name	Type	Description
action*	string	Gmail action to perform`searchread_messageread_threadget_attachmentlist_labelscreate_draftsend_message`
query	string	Gmail query like "from:john unread" or "invoice"
max_results	integer	Maximum number of messages to return
message_id	string	Message ID for read_message
thread_id	string	Thread ID for read_thread
attachment_id	string	Attachment ID for get_attachment
filename	string	Attachment filename for display
include_body	boolean	Include decoded body content in the response
include_attachments	boolean	Include attachment metadata in the response
to	array	Recipient email list
cc	array	CC email list
bcc	array	BCC email list
subject	string	Email subject
body	string	Email body content

* required

Work in GitHub, Slack, Jira, Linear, Notion, Google, Stripe and more.