Gmail - All Email Actions by Apoth3osis

Name: Gmail - All Email Actions
Brand: Apoth3osis
SKU: 69618e485d4cf4d4b6af40f0
Price: 0.05 USD
Availability: InStock

Gmail - All Email Actions

Connector

Available ActionsEach successful request consumes credits as outlined below.

send_message^5crreply_message^5crforward_message^5crlist_messages^5crget_message^5crget_thread^5crtrash_message^5cruntrash_message^5crmodify_labels^5crlist_labels^5crcreate_draft^5crsend_draft^5crget_draft^5crdelete_draft^5crget_profile^5cr

Details

Gmail connection that enables agents to send, read, search, and manage email through Google OAuth integration. The tool provides comprehensive email functionality including composing and sending new messages with attachments, replying to emails while maintaining thread continuity, and forwarding messages to new recipients. Agents can search and filter emails using Gmail's powerful query syntax to find specific messages by sender, subject, date, labels, or attachment status. The tool supports full email lifecycle management including reading message content with parsed headers and body text, moving messages to trash or permanently deleting them, and modifying labels to organize emails or mark them as read. Draft functionality allows agents to create, retrieve, and send draft emails for workflows requiring human review before sending. Additional capabilities include listing all available labels for organization, retrieving user profile information such as email address and message counts, and sending from custom authenticated email addresses.

Workflows Using This Tool

2 / 12

Workflow

Saves ~30 min

Hourly Gmail Categorizer with Urgent Telegram Alerts

Runs every hour to fetch unread Gmail emails, categorizes them into four buckets (Account Notifications, Marketing, Human, Urgent), and sends a Telegram alert for any urgent emails that need a timely response. Non-urgent runs are logged silently.

Use Cases

Automated email notifications and alerts, Customer inquiry response and follow-up, Email search and retrieval for information gathering, Inbox management and organization with labels, Draft creation for human-in-the-loop email workflows, Email forwarding and delegation workflows, Reading and summarizing email content, Marking messages as read or starring important emails, Sending reports and documents as attachments, Monitoring inbox for specific senders or keywords

Dynamic MCP Setup

Connect once through AgentPMT Dynamic MCP, then use approved tools from the same agent connection.

30 Second Setup

STDIO connector for Claude Code, Codex, Cursor, Zed, and other LLMs that require STDIO or custom connections.

npm install -g @agentpmt/mcp-routeragentpmt-setup

Hosted Streamable HTTPS

MCP endpoint for browser-based apps like ChatGPT, Claude, Grok, or any time you want a streamable connection with no local install.

https://api.agentpmt.com/mcp

Config Example

Use the hosted endpoint directly in clients that support remote MCP. Store your Bearer token in the client config or secret field.

Full connection guide

{
  "mcpServers": {
    "agentpmt": {
      "type": "streamable-http",
      "url": "https://api.agentpmt.com/mcp",
      "headers": {
        "Authorization": "Bearer <AGENTPMT_BEARER_TOKEN>",
        "x-instance-metadata": "{\"client\":\"generic-mcp\",\"platform\":\"remote\"}"
      }
    }
  }
}

Need client videos, organization controls, audit details, and the full feature overview?

More About Dynamic MCP

Credentials

Google OAuth *

Connect your Google account.

oauth token

Manage credentials in your dashboard.

Actions(15)

send_message^5cr9 params(2 required)

Send a new email. Supports plain text, HTML, attachments, CC/BCC, custom from address, and optional thread continuation.

torequiredarray

Recipient email addresses.

Array of: string

subjectrequiredstring

Email subject line.

body_textstring

Plain text email body. Required unless body_html is provided.

body_htmlstring

HTML email body. Can be used instead of or in addition to body_text.

ccarray

CC recipients.

Array of: string

bccarray

BCC recipients.

Array of: string

from_emailstring

From address override. Only works if the Gmail account has a configured send-as alias.

thread_idstring

Thread ID to add this message to an existing conversation thread.

attachmentsarray

Email attachments. Provide public file URLs that will be fetched and attached.

Array of: object

reply_message^5cr6 params(1 required)

Reply to an existing email. The reply stays in the same thread and automatically uses the original subject and recipient context.

message_idrequiredstring

Gmail message ID of the email to reply to.

body_textstring

Plain text reply body. Required unless body_html is provided.

body_htmlstring

HTML reply body. Can be used instead of or in addition to body_text.

ccarray

CC recipients.

Array of: string

bccarray

BCC recipients.

Array of: string

attachmentsarray

Email attachments. Provide public file URLs that will be fetched and attached.

Array of: object

forward_message^5cr6 params(2 required)

Forward an email to new recipients. The source message content is included automatically.

message_idrequiredstring

Gmail message ID of the email to forward.

torequiredarray

Recipient email addresses to forward to.

Array of: string

body_textstring

Optional text to add above the forwarded content.

ccarray

CC recipients.

Array of: string

bccarray

BCC recipients.

Array of: string

attachmentsarray

Additional email attachments. Provide public file URLs that will be fetched and attached.

Array of: object

list_messages^5cr10 params

Search and list Gmail messages for triage. The tool requests a Gmail message page, fetches compact metadata for each listed message, then applies post-fetch date/category/label filters and optional thread dedupe. Returns messages plus result_size_estimate, next_page_token, fetched_count, and returned_count; returned_count can be lower than fetched_count.

qstring

Gmail search query. Examples: is:unread, from:user@example.com, subject:meeting, has:attachment, newer_than:7d.

max_resultsinteger

Maximum Gmail API page size before metadata shaping, post-fetch filters, and thread dedupe (1-500).

Default: 20

Range: 1 - 500

page_tokenstring

Pagination token from a previous list_messages response.

label_idsarray

Include only messages with these Gmail label IDs in the upstream Gmail list request.

Array of: string

include_spam_trashboolean

Include spam and trash in the upstream Gmail list request. Defaults to false.

Default: false

min_internal_date_msinteger

Post-fetch filter: exclude messages with internalDate earlier than this millisecond timestamp.

Range: 0 - ...

max_internal_date_msinteger

Post-fetch filter: exclude messages with internalDate later than this millisecond timestamp.

Range: 0 - ...

exclude_label_idsarray

Post-fetch filter: exclude messages containing any of these Gmail label IDs.

Array of: string

exclude_categoriesarray

Post-fetch filter: exclude Gmail categories such as promotions, social, updates, and forums.

Array of: string

dedupe_by_threadboolean

Return only the first retained message per thread after post-fetch filters. Defaults to true.

Default: true

get_message^5cr6 params(1 required)

Read a Gmail message with safe body and metadata controls.

message_idrequiredstring

Gmail message ID.

message_formatstring

Preferred read format. minimal returns IDs/labels only; metadata returns headers/snippet/signals with no body fields; text returns capped text only; full returns metadata plus selected body fields.

Values:

minimalmetadatatextfull

formatstring

Deprecated legacy alias for message_format. Use message_format for new calls.

Values:

fullmetadataminimal

metadata_headersarray

Headers to request and return in metadata modes.

Array of: string

body_formatstring

Body fields to return when message_format is full. Defaults to text. Use html or both only when raw HTML is explicitly needed.

Values:

nonetexthtmlboth

max_body_charsinteger

Maximum characters returned per selected body field. Defaults to 8000.

Range: 0 - 100000

get_thread^5cr8 params(1 required)

Read Gmail thread messages with safe body and metadata controls.

thread_idrequiredstring

Gmail thread ID.

message_formatstring

Preferred read format for thread messages: minimal, metadata, text, or full.

Values:

minimalmetadatatextfull

formatstring

Deprecated legacy alias for message_format. Use message_format for new calls.

Values:

fullmetadataminimal

metadata_headersarray

Headers to request and return in metadata modes.

Array of: string

body_formatstring

Body fields to return when message_format is full. Defaults to text.

Values:

nonetexthtmlboth

max_body_charsinteger

Maximum characters returned per selected body field. Defaults to 8000.

Range: 0 - 100000

max_messagesinteger

Maximum thread messages to return (1-100). Defaults to 25.

Default: 25

Range: 1 - 100

include_htmlboolean

Shortcut that includes HTML when body_format is omitted. Defaults to false; body_format is the canonical selector.

Default: false

trash_message^5cr1 param(1 required)

Move an email message to trash.

message_idrequiredstring

Gmail message ID of the email to trash.

untrash_message^5cr1 param(1 required)

Restore an email message from trash.

message_idrequiredstring

Gmail message ID of the email to restore.

modify_labels^5cr3 params(1 required)

Add or remove labels from an email. Common uses: mark as read, star, or archive.

message_idrequiredstring

Gmail message ID.

add_label_idsarray

Label IDs to add. Common values: STARRED, IMPORTANT, UNREAD.

Array of: string

remove_label_idsarray

Label IDs to remove. Common values: UNREAD to mark read, INBOX to archive.

Array of: string

list_labels^5cr0 params

List all available Gmail labels, including system and user-created labels.

No parameters for this action.

create_draft^5cr9 params(2 required)

Create a draft email that can be edited or sent later.

torequiredarray

Recipient email addresses.

Array of: string

subjectrequiredstring

Email subject line.

body_textstring

Plain text email body. Required unless body_html is provided.

body_htmlstring

HTML email body. Can be used instead of or in addition to body_text.

ccarray

CC recipients.

Array of: string

bccarray

BCC recipients.

Array of: string

from_emailstring

From address override. Only works if the Gmail account has a configured send-as alias.

thread_idstring

Thread ID to associate the draft with an existing conversation.

attachmentsarray

Email attachments. Provide public file URLs that will be fetched and attached.

Array of: object

send_draft^5cr1 param(1 required)

Send a previously created Gmail draft.

draft_idrequiredstring

Gmail draft ID.

get_draft^5cr6 params(1 required)

Retrieve draft email content with safe body and metadata controls.

draft_idrequiredstring

Gmail draft ID.

message_formatstring

Preferred read format: minimal, metadata, text, or full.

Values:

minimalmetadatatextfull

formatstring

Deprecated legacy alias for message_format. Use message_format for new calls.

Values:

fullmetadataminimal

metadata_headersarray

Headers to request and return in metadata modes.

Array of: string

body_formatstring

Body fields to return when message_format is full. Defaults to text.

Values:

nonetexthtmlboth

max_body_charsinteger

Maximum characters returned per selected body field. Defaults to 8000.

Range: 0 - 100000

delete_draft^5cr1 param(1 required)

Permanently delete a Gmail draft.

draft_idrequiredstring

Gmail draft ID to delete.

get_profile^5cr0 params

Get the authenticated Gmail profile including email address and message/thread counts.

No parameters for this action.

curl -X POST "https://api.agentpmt.com/products/purchase" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ********" \
  -d '{
    "product_id": "69618e485d4cf4d4b6af40f0",
    "parameters": {
      "action": "get_instructions"
    }
  }'

import requests
import json

url = "https://api.agentpmt.com/products/purchase"

headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer ********"
}

data = {
    "product_id": "69618e485d4cf4d4b6af40f0",
    "parameters": {
        "action": "get_instructions"
    }
}

response = requests.post(url, headers=headers, json=data)
print(response.status_code)
print(response.json())

const url = "https://api.agentpmt.com/products/purchase";

const headers = {
  "Content-Type": "application/json",
  "Authorization": "Bearer ********"
};

const data = {
  product_id: "69618e485d4cf4d4b6af40f0",
  parameters: {
    "action": "get_instructions"
  }
};

fetch(url, {
  method: "POST",
  headers,
  body: JSON.stringify(data)
})
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error("Error:", error));

const axios = require('axios');

const url = "https://api.agentpmt.com/products/purchase";

const headers = {
  "Content-Type": "application/json",
  "Authorization": "Bearer ********"
};

const data = {
  product_id: "69618e485d4cf4d4b6af40f0",
  parameters: {
    "action": "get_instructions"
  }
};

axios.post(url, data, { headers })
  .then(response => {
    console.log(response.status);
    console.log(response.data);
  })
  .catch(error => {
    console.error("Error:", error.message);
  });

Login to view your API and budget keys. The example above uses placeholder values. Sign in to see personalized code with your bearer token.

Autonomous agents can access this tool through AgentAddress credit balances or direct x402 payments. Use the Autonomous Agent API reference for endpoint shapes after choosing the access pattern below.

Recommended

Credit-Based Access Using AgentAddress

AgentAddress is preferred when an autonomous agent needs persistent file access, stored platform state, or maximum tool use ability across repeated calls.

Open Credit-Based Access Using AgentAddress

Direct x402 Payment

Use direct x402 for independent one-off tool calls that do not require shared files or stored platform state.

Accepted public payments

Stablecoin: USDC
Chains: Base, Arbitrum, Optimism, Polygon, and Avalanche

Direct x402 payments are not enabled for this product; use AgentAddress credit access instead.

Product Skill Package

This product has a published Agent Skill package. Install it when an autonomous agent needs product-specific operating instructions in its local skill registry.

Download SKILL.md View package source OpenClaw listing

OpenClaw install

Copied to clipboard

skills.sh install

Copied to clipboard

Usage Instructions

Usage guidance provided directly by the developer for this product.

Gmail - All Email Actions

Complete Gmail management: send, reply, forward, search, read, trash, label, and draft emails.

Actions

send_message

Send a new email.

Required: to (array of email addresses), subject, body_text or body_html Optional: cc, bcc, from_email (requires send-as alias configured in Gmail), body_html, attachments, thread_id

{
  "action": "send_message",
  "to": ["recipient@example.com"],
  "subject": "Project Update",
  "body_text": "Hi, here is the latest update on the project.",
  "cc": ["manager@example.com"]
}

With attachment:

{
  "action": "send_message",
  "to": ["team@example.com"],
  "subject": "Monthly Report",
  "body_text": "Please find the report attached.",
  "attachments": [
    {
      "filename": "report.pdf",
      "file_url": "https://example.com/files/report.pdf",
      "content_type": "application/pdf"
    }
  ]
}

reply_message

Reply to an existing email. The reply stays in the same thread and automatically uses the original subject and recipient.

Required: message_id, body_text or body_html Optional: cc, bcc, attachments

{
  "action": "reply_message",
  "message_id": "18a1b2c3d4e5f6g7",
  "body_text": "Thanks for the update. I'll review this by Friday."
}

forward_message

Forward an email to new recipients. The original message content is included automatically.

Required: message_id, to Optional: body_text (added above the forwarded content), cc, bcc, attachments

{
  "action": "forward_message",
  "message_id": "18a1b2c3d4e5f6g7",
  "to": ["colleague@example.com"],
  "body_text": "FYI - see the message below."
}

list_messages

Search and list emails. Returns message IDs and thread IDs. Use get_message to read full content.

Required: none Optional: q (Gmail search query), max_results (1-500, default 20), label_ids, page_token

{
  "action": "list_messages",
  "q": "is:unread from:boss@example.com",
  "max_results": 10
}

Common search queries:

is:unread - unread messages
from:user@example.com - from a specific sender
subject:meeting - subject contains "meeting"
has:attachment - messages with attachments
newer_than:7d - from the last 7 days
older_than:30d - older than 30 days
in:sent - sent messages
label:work - messages with a specific label

get_message

Read the full content of an email including headers, body, and attachment metadata.

Required: message_id Optional: format - full (default, headers + body), metadata (headers only), minimal (IDs only)

{
  "action": "get_message",
  "message_id": "18a1b2c3d4e5f6g7",
  "format": "full"
}

trash_message

Move an email to the trash.

Required: message_id

{
  "action": "trash_message",
  "message_id": "18a1b2c3d4e5f6g7"
}

untrash_message

Restore an email from the trash back to its original location.

Required: message_id

{
  "action": "untrash_message",
  "message_id": "18a1b2c3d4e5f6g7"
}

modify_labels

Add or remove labels from an email. Use list_labels first to find available label IDs.

Required: message_id, at least one of add_label_ids or remove_label_ids

{
  "action": "modify_labels",
  "message_id": "18a1b2c3d4e5f6g7",
  "add_label_ids": ["STARRED"],
  "remove_label_ids": ["UNREAD"]
}

Common label IDs: INBOX, SENT, TRASH, DRAFT, SPAM, STARRED, IMPORTANT, UNREAD, CATEGORY_PERSONAL, CATEGORY_SOCIAL, CATEGORY_PROMOTIONS

Useful patterns:

Mark as read: remove_label_ids: ["UNREAD"]
Mark as unread: add_label_ids: ["UNREAD"]
Archive: remove_label_ids: ["INBOX"]
Star: add_label_ids: ["STARRED"]

list_labels

Get all available labels (system and user-created).

Required: none

{
  "action": "list_labels"
}

create_draft

Create a draft email that can be edited or sent later.

Required: to, subject, body_text or body_html Optional: cc, bcc, from_email, body_html, attachments, thread_id

{
  "action": "create_draft",
  "to": ["client@example.com"],
  "subject": "Proposal Draft",
  "body_html": "<h1>Proposal</h1><p>Here are the details...</p>"
}

send_draft

Send a previously created draft.

Required: draft_id

{
  "action": "send_draft",
  "draft_id": "r123456789"
}

get_draft

Retrieve the content of a draft.

Required: draft_id Optional: format - full (default), metadata, minimal

{
  "action": "get_draft",
  "draft_id": "r123456789"
}

delete_draft

Permanently delete a draft.

Required: draft_id

{
  "action": "delete_draft",
  "draft_id": "r123456789"
}

get_profile

Get the authenticated user's Gmail profile including email address and message counts.

Required: none

{
  "action": "get_profile"
}

Common Workflows

Check and read unread emails:

list_messages with q: "is:unread" to get message IDs
get_message for each message ID to read content
modify_labels with remove_label_ids: ["UNREAD"] to mark as read

Send email with review:

create_draft to compose the email
get_draft to review content
send_draft to send, or delete_draft to discard

Reply to a conversation:

list_messages with a search query to find the thread
get_message to read the message you want to reply to
reply_message with the message_id and your response

Organize inbox:

list_messages to find messages
list_labels to see available labels
modify_labels to apply labels, archive, or star messages

Important Notes

Attachments: Provide public URLs for file attachments. The files are fetched and attached automatically. Content type is auto-detected if not specified.
HTML emails: You can send both body_text and body_html together. Recipients who support HTML will see the rich version; others see plain text.
Search syntax: The q parameter uses standard Gmail search operators. Combine multiple operators for precise filtering (e.g., from:alice@example.com newer_than:7d has:attachment).
Pagination: When list_messages returns a next_page_token, pass it as page_token in the next request to get more results.
From address: The from_email field only works if you have configured a send-as alias in Gmail settings.
Thread management: Use thread_id with send_message or create_draft to add a message to an existing conversation thread.

Frequently Asked Questions

How do I connect this tool to an external agent?

You can install the local MCP server by opening a terminal and running:

Install commands

npm install -g @agentpmt/mcp-router
agentpmt-setup

This will connect you to local agents like Claude Code, Windsurf, Grok Build, Cursor, etc.

Alternatively you can connect to the hosted version with this config block, no installation required:

Hosted MCP config

{
  "mcpServers": {
    "agentpmt": {
      "type": "streamable-http",
      "url": "https://api.agentpmt.com/mcp",
      "headers": {
        "Authorization": "Bearer <AGENTPMT_BEARER_TOKEN>",
        "x-instance-metadata": "{\"client\":\"generic-mcp\",\"platform\":\"remote\"}"
      }
    }
  }
}

View MCP Connection Instructions for more details.

How does an external agent use this tool?

After the external agent is connected to an Agent Group that can use this tool, paste this prompt into the agent:

Agent prompt

Use the AgentPMT-Tool-Search-and-Execution tool. First call action 'get_instructions' so you know how to use the tool search interface. Then call action 'get_schema' with tool_id 69618e485d4cf4d4b6af40f0 ("Gmail - All Email Actions"). After reading the schema and any returned instructions, tell me what this tool can do, we are going to be using it

The agent should fetch the tool schema first, collect the required parameters for your request, and then call the tool through AgentPMT.

Gmail - All Email Actions

Available ActionsEach successful request consumes credits as outlined below.

Details

Workflows Using This Tool

Hourly Gmail Categorizer with Urgent Telegram Alerts

Use Cases

Dynamic MCP Setup

30 Second Setup

Hosted Streamable HTTPS

Config Example

Credentials

Actions(15)

Credit-Based Access Using AgentAddress

Direct x402 Payment

Product Skill Package

Usage Instructions

Gmail - All Email Actions

Actions

send_message

reply_message

forward_message

list_messages

get_message

trash_message

untrash_message

modify_labels

list_labels

create_draft

send_draft

get_draft

delete_draft

get_profile

Common Workflows

Important Notes

Frequently Asked Questions

How do I connect this tool to an external agent?

How does an external agent use this tool?

Related Content

Build a Gmail-to-Telegram AI Workflow in 60 Seconds

Looking for help integrating AI into your business? Set up a free consultation.