add-gmail

Enable Gmail read, send, and email management for BioClaw agents.

401|53|Updated Feb 26, 2026
One-click install
npx skills add https://github.com/Runchuan-BU/BioClaw --skill add-gmail-runchuan-bu
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: add-gmail
Source: https://github.com/Runchuan-BU/BioClaw/tree/main/.claude/skills/add-gmail
Command: npx skills add https://github.com/Runchuan-BU/BioClaw --skill add-gmail-runchuan-bu

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill enables BioClaw to interact with Gmail so the agent can read, send, and respond to emails, removing the need for manual email handling outside the chat interface.

Core Features & Use Cases

  • Two operation modes: Tool Mode for on-demand read/send from WhatsApp and Channel Mode for email-triggered tasks, scheduled actions, and email replies.
  • End-to-end integration: Guides GCP OAuth setup, mounts credentials into containers, registers MCP tools, and adds optional polling and state tracking for processed emails.
  • Use Case: Automatically process emails labeled "BioClaw" to trigger agent workflows, reply to requests, and maintain per-thread context for follow-up correspondence.

Quick Start

Send the message "@Bio check my recent emails" in your WhatsApp group to have the agent fetch and summarize unread Gmail messages.

Frequently Asked Questions about add-gmail

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I integrate Gmail with a WhatsApp agent for email-triggered workflows?

You can trigger agent tasks from Gmail by using Channel Mode, which supports email-triggered actions, scheduled workflows, and automated replies while maintaining per-thread context for follow-up correspondence.

What is needed to set up GCP OAuth credentials for Gmail MCP access?

The integration uses the @gongrzhe/server-gmail-autoauth-mcp package via npx, satisfying the OAuth-based GCP credential management required for secure Gmail access.

Can I use Gmail to trigger automated agent tasks in a WhatsApp group context?

You can message your agent to fetch and summarize unread Gmail messages on-demand, or configure optional polling with trigger and context modes for continuous email processing.

How does an agent handle on-demand email reading versus scheduled email workflows?

Channel Mode enables email-triggered tasks by processing specific labels, whereas Tool Mode simply allows the agent to read and send emails whenever prompted by a user in the chat.

Are there limitations when using npx to run the server-gmail-autoauth-mcp integration?

Limitations include the need for continuous polling configuration in Channel Mode to track processed emails and maintain per-thread context, which may increase resource usage depending on email volume.