Mail

Gmail Mail

Use this skill to list recent Gmail threads, inspect a thread in detail, or send a new email.

When to use

• review recent inbox threads
• inspect a thread before replying manually
• send a plain text or HTML email

Authentication

This skill uses the connected gmail provider credential for the current agent.

Invocation

Read actions can be called through Shift's Skill Router:

curl -X POST "$SHIFT_LOCAL_GATEWAY/skill-router/invoke" \
  -H "Content-Type: application/json" \
  -d '{
    "skillProvider": "gmail",
    "skill": "mail",
    "action": "list-threads",
    "input": {
      "maxResults": 10
    }
  }'

For sending email, use the precompiled code skill:

node dist/index.js '{"operation":"send","to":"user@example.com","subject":"Hello","text":"Hi from Shift."}'

Examples

List threads:

{
  "skillProvider": "gmail",
  "skill": "mail",
  "action": "list-threads",
  "input": {
    "query": "label:inbox newer_than:7d",
    "maxResults": 10
  }
}

Get a thread:

{
  "skillProvider": "gmail",
  "skill": "mail",
  "action": "get-thread",
  "input": {
    "threadId": "THREAD_ID"
  }
}

Send plain text:

node dist/index.js '{"operation":"send","to":"user@example.com","subject":"Launch update","text":"The launch is on track."}'

Send HTML:

node dist/index.js '{"operation":"send","to":["user@example.com"],"subject":"Weekly Digest","html":"<h1>Weekly Digest</h1><p>Everything is on track.</p>"}'