Google Workspace · Email
GOOGLE_WORKSPACE_GMAIL_LIST_MESSAGES
Search or list Gmail messages from the connected Google Workspace account. Returns { messages, resultSizeEstimate, nextPageToken }.
- Provider
- Google Workspace
- Access
- Read
- Category
- Version
- v1
Input schema
{
"type": "object",
"properties": {
"q": {
"type": "string",
"description": "Optional Gmail search query, e.g. from:client@example.com newer_than:7d."
},
"labelIds": {
"type": "array",
"items": {
"type": "string"
},
"description": "Optional Gmail label IDs, e.g. INBOX or SENT."
},
"maxResults": {
"type": "number",
"description": "Max messages to return (default 10)."
},
"pageToken": {
"type": "string",
"description": "Optional page token from a prior response."
}
},
"additionalProperties": false
}How to call it
Expose this tool to any MCP-capable agent (Claude, GPT, or your own) through CybrLink's MCP server. The agent calls google_workspace_gmail_list_messages with arguments matching the schema above.
CybrLink validates the input, injects the connected Google Workspace credentials server-side, and runs a single scoped provider API call through the shared proxy — the same guarded path as the generic call_api tool. The raw secret never reaches the model, and the response is trimmed to just the fields the agent needs.
Frequently asked
- How do I let an AI agent google workspace gmail list messages?
- Connect Google Workspace to CybrLink, then expose the `google_workspace_gmail_list_messages` tool to any MCP-capable agent (Claude, GPT, or a custom framework). The agent calls it with typed arguments; CybrLink injects the Google Workspace credential server-side and runs one scoped API call. Search or list Gmail messages from the connected Google Workspace account. Returns { messages, resultSizeEstimate, nextPageToken }.
- Does the AI model see my Google Workspace credentials when using GOOGLE_WORKSPACE_GMAIL_LIST_MESSAGES?
- No. CybrLink stores the credential in a token vault and injects it on the server for each call, so the model can read this data from Google Workspace without the OAuth token or API key ever entering its context.