Gmail / warm

Get Message

Retrieve a single Gmail message by id. Useful for thread parsing, reply inspection, and delivery verification.

Quick Start

aweb inspect gmail.get_message
aweb add gmail
aweb plan "use Gmail get message in an agent workflow"

import Aweb, { Agent } from '@aweb/sdk';

const aweb = new Aweb({ apiKey: process.env.AWEB_API_KEY });
const agent = new Agent({ tools: aweb.tools });

agent.add('gmail');

const plan = await agent.plan('Use Gmail for this workflow');
const tool = await aweb.tools.inspect('gmail.get_message');

console.log(plan.nextAction);
console.log(tool.inputSchema);

Tool Card

Tool idgmail.get_message

ProviderGmail (gmail)

Tool nameget_message

Activationwarm

Healthhealthy

Trust score1.00

Transportstreamable_http

Latencynot yet measured

Cost0

Requirements and Governance

Authoauth_2_1_pkce

Credentialsetup_required

Workspacerequired

Approvalnone

RiskREAD

Permissionshttps://www.googleapis.com/auth/gmail.readonly, https://www.googleapis.com/auth/gmail.compose, https://www.googleapis.com/auth/gmail.send, read

Credential setup/api/mcp-warehouse/credentials/gmail/init

Schemas

{
  "type": "object",
  "properties": {
    "message_id": {
      "type": "string",
      "description": "Gmail message id."
    },
    "format": {
      "type": "string",
      "enum": [
        "full",
        "metadata",
        "minimal"
      ],
      "description": "Response format. Default: metadata."
    }
  },
  "required": [
    "message_id"
  ],
  "additionalProperties": false
}

Examples

[
  {
    "objective": "Use Gmail get message in an agent workflow.",
    "args": {
      "message_id": "<message_id>",
      "format": "<format>"
    }
  }
]

Back to MCP Tool Cards