Gmail - All Email Actions

Available ActionsEach successful request consumes credits as outlined below.

send_message^5crreply_message^5crforward_message^5crlist_messages^5crget_message^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.

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

Connect Your Agent In 5 Min

Watch the setup guide for your platform

Or Install Locally

STDIO connector for Claude Code, Codex, Cursor, Zed, and other LLMs that require STDIO or custom connections. This lightweight connector routes requests to https://api.agentpmt.com/mcp. All tool execution happens in the cloud and the server cannot edit any files on your computer.

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

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

import requests
import json

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

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

data = {
    "product_id": "69618e485d4cf4d4b6af40f0",
    "parameters": {
        "action": "send_message",
        "to": [],
        "subject": "example_subject"
    }
}

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": "send_message",
    "to": [],
    "subject": "example_subject"
  }
};

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": "send_message",
    "to": [],
    "subject": "example_subject"
  }
};

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.

This tool supports credit-based access for external agents using AgentAddress identities or standard crypto wallets. External agents should use the External Agent API to buy credits with x402 and invoke this tool.

1. Buy Credits

Purchase credits via x402 payment (500 credit minimum, 100 credits = $1).

# Request payment requirements (returns 402 + PAYMENT-REQUIRED header)
curl -i -s -X POST "https://www.agentpmt.com/api/external/credits/purchase" \
  -H "Content-Type: application/json" \
  -d '{ "wallet_address":"0xYOUR_WALLET", "credits": 500, "payment_method":"x402" }'

# Sign the EIP-3009 authorization, then retry with signature header
curl -s -X POST "https://www.agentpmt.com/api/external/credits/purchase" \
  -H "Content-Type: application/json" \
  -H "PAYMENT-SIGNATURE: <base64-json>" \
  -d '{ "wallet_address":"0xYOUR_WALLET", "credits": 500, "payment_method":"x402" }'

2. Create a Session Nonce (nonce used in signed balance/invoke)

curl -s -X POST "https://www.agentpmt.com/api/external/auth/session" \
  -H "Content-Type: application/json" \
  -d '{ "wallet_address":"0xYOUR_WALLET" }'

3. Invoke This Tool

Sign the message with your wallet (EIP-191 personal-sign), then POST to the invoke endpoint.

# Sign this message (wallet MUST be lowercased):
# agentpmt-external
# wallet:0xyourwallet...
# session:<session_nonce>
# request:<request_id>
# action:invoke
# product:69618e485d4cf4d4b6af40f0
# payload:<sha256(canonical_json(parameters))>

curl -s -X POST "https://www.agentpmt.com/api/external/tools/69618e485d4cf4d4b6af40f0/invoke" \
  -H "Content-Type: application/json" \
  -d '{
    "wallet_address": "0xYOUR_WALLET",
    "session_nonce": "<session_nonce>",
    "request_id": "invoke-uuid",
    "signature": "0x<signature>",
    "parameters": {
      "action": "your_action",
      "your_param": "value"
    }
  }'

Credentials

Google OAuth *

Connect your Google account.

oauth token

Manage credentials in your dashboard.

Actions(14)

send_message^5cr9 params(2 required)

Send a new email. Supports plain text, HTML, attachments, CC/BCC, and custom from address (requires send-as alias).

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 to override the default sender. Only works if a send-as alias is configured in Gmail settings.

thread_idstring

Thread ID to add this message to an existing conversation thread

attachmentsarray

File 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.

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

File attachments

Array of: object

forward_message^5cr6 params(2 required)

Forward an email to new recipients. The original 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 file attachments

Array of: object

list_messages^5cr4 params

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

qstring

Gmail search query (e.g., 'is:unread', 'from:user@example.com', 'subject:meeting', 'has:attachment', 'newer_than:7d')

max_resultsinteger

Maximum results to return (1-500)

Default: 20

Range: 1 - 500

label_idsarray

Filter by these label IDs

Array of: string

page_tokenstring

Pagination token from a previous list_messages response

get_message^5cr2 params(1 required)

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

message_idrequiredstring

Gmail message ID

message_formatstring

Message format: full (headers + body, default), metadata (headers only), minimal (IDs only)

Values:

fullmetadataminimal

Default: full

trash_message^5cr1 param(1 required)

Move an email to the trash.

message_idrequiredstring

Gmail message ID of the email to trash

untrash_message^5cr1 param(1 required)

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

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 (remove UNREAD), star (add STARRED), archive (remove INBOX).

message_idrequiredstring

Gmail message ID

add_label_idsarray

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

Array of: string

remove_label_idsarray

Label IDs to remove. Common: UNREAD (mark as read), INBOX (archive)

Array of: string

list_labels^5cr0 params

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

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 (requires send-as alias)

thread_idstring

Thread ID to associate the draft with an existing conversation

attachmentsarray

File attachments

Array of: object

send_draft^5cr1 param(1 required)

Send a previously created draft email.

draft_idrequiredstring

Gmail draft ID

get_draft^5cr2 params(1 required)

Retrieve the content of a draft email.

draft_idrequiredstring

Gmail draft ID

message_formatstring

Message format: full (default), metadata, minimal

Values:

fullmetadataminimal

Default: full

delete_draft^5cr1 param(1 required)

Permanently delete a draft email.

draft_idrequiredstring

Gmail draft ID to delete

get_profile^5cr0 params

Get the authenticated user's Gmail profile including email address, total message count, and total thread count.

No parameters for this action.

Usage Instructions

Usage guidance provided directly by the developer for this product.

Gmail - All Email Actions

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

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.

About The Developer

Apoth3osis

★15 stars

Joined Agent Payment: August 14, 2025

We build tools that enable AI agents to excel in the mathematical realm.

Our small team develops experimental and unique solutions in the AI arena, with a strong focus on modular computing for agentic applications and custom model deployment. We have handled projects for a variety of applications across many sectors, from algorithmic trading and financial analysis, to molecular simulations and predictions, to habitat and biodiversity monitoring and wildlife conservation.

Gmail - All Email Actions

Description