1. Docs
2. /
3. Tool reference
4. /
5. Email
6. /
7. searchEmails

Email

searchEmails

Search Emails

Search the user's Gmail messages with Gmail query syntax ('from:user@example.com', 'is:unread', 'subject:meeting', 'in:sent').

readexternal

Ask Claude, ChatGPT, Cursor or any AI connected to The Cloud "find emails from X", and it calls searchEmails.

Example call

The MCP tools/call params, with the required arguments only.

{
  "arguments": {
    "query": "<query>"
  },
  "name": "searchEmails"
}

Arguments

• accountIdstringoptionalConnected account this acts on: an accountId or email from listMailAccounts. Omit for the primary account. Pass the SAME account you found the message / draft / label in: a Gmail id is per-account, so aiming a non-primary id at the…
• maxResultsnumberoptionalMaximum number of results
• querystringrequiredGmail search query

Returns

The registry does not declare a return shape.

Declared limits

• maxResults: minimum 1
• maxResults: maximum 50

Ask for it

The Cloud routes these requests to this verb.

• find emails from X
• search my inbox for Y
• any unread mail

Pair it with

The verbs that finish the job.

• readEmail
• listMailAccounts

Questions

• What does searchEmails do?

  Search the user's Gmail messages with Gmail query syntax ('from:user@example.com', 'is:unread', 'subject:meeting', 'in:sent'). It is one of the tools The Cloud MCP server gives every connected AI.

• How do I use searchEmails from Claude or ChatGPT?

  Connect your AI to The Cloud at https://mcp.thecloud.so/mcp and sign in once. Then ask Claude, ChatGPT, Cursor or any AI connected to The Cloud "find emails from X", and it calls searchEmails.

• Is searchEmails safe to let an AI call?

  searchEmails is read-only: it changes nothing. It reaches a system outside The Cloud on your behalf.

Connect

One endpoint gives your AI this tool and every other one: connect Claude, ChatGPT, Cursor or Gemini, read what The Cloud is, or see pricing.