skills.rest
wientjes
wientjesCOMMUNITY
Explore all skills by this author →
GitHub

add-gmail

Integrates NanoClaw with Gmail for reading, sending and polling emails via OAuth MCP tooling.

Updated Feb 23, 2026
Search Tags:#integration#oauth#gcp#agent#mcp#email#gmail
One-click install
npx skills add https://github.com/wientjes/gforce-nanoclaw --skill add-gmail-wientjes
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: add-gmail
Source: https://github.com/wientjes/gforce-nanoclaw/tree/main/.claude/skills/add-gmail
Command: npx skills add https://github.com/wientjes/gforce-nanoclaw --skill add-gmail-wientjes

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill connects NanoClaw to Gmail so agents can read, send, and be triggered by email, removing manual checks and enabling email-driven workflows directly from your agent environment.

Core Features & Use Cases

  • Two operation modes: Tool Mode for on-demand read/send from WhatsApp and Channel Mode for polling emails to trigger agents and schedule tasks.
  • Secure OAuth flow: Guides the user through Google Cloud OAuth setup and stores credentials in a local ~/.gmail-mcp directory for container mounting.
  • End-to-end integration: Adds MCP tooling, container volume mounts, database tracking for processed emails, and optional IPC tools for in-session email actions.

Quick Start

Run the setup guide, provide or paste your GCP OAuth JSON, authorize the app in your browser, and let the Skill configure credentials for NanoClaw.

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 to trigger agent tasks from incoming emails?▼

Gmail integration enables agents to read, send, and process emails by configuring Google Cloud OAuth credentials and setting up email polling to spawn or schedule agent tasks automatically. It supports both on-demand tool scenarios and full channel polling workflows via database tracking.

What do I need to set up Google Cloud OAuth for Gmail agent integration?▼

Google Cloud OAuth setup requires storing credentials in a local ~/.gmail-mcp directory for container mounting. You must provide your GCP OAuth JSON, authorize the app in your browser, and configure container volume mounts for agent access.

Can I use Gmail to send emails on demand from a WhatsApp-triggered agent?▼

Yes, Gmail integration supports Tool Mode for on-demand reading and sending emails directly from WhatsApp-triggered agents, allowing seamless email-driven workflows without manual checks or full channel polling.

How does email polling work to spawn and schedule agent tasks?▼

Email polling operates in Channel Mode, checking incoming mail to trigger agents and schedule tasks. It requires database tracking for processed emails and code changes to the agent-runner and app database to prevent duplicate processing.

Does Gmail integration require the @gongrzhe/server-gmail-autoauth-mcp MCP tool?▼

Yes, the @gongrzhe/server-gmail-autoauth-mcp MCP tool is required and must be available via npx. It works alongside the stored Google Cloud OAuth credentials to enable agents to read, send, and process emails.

What are the limitations of using Gmail integration for agent workflows?▼

Gmail integration requires mandatory Google Cloud OAuth credentials, container mounts for the credentials directory, and code changes to agent-runner and the app database for tracking processed emails. It cannot operate without these environment configurations.

Related Skills

Explore More Software Engineering Skills→
Runchuan-BURunchuan-BU
401

add-gmail

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

Community
Advanced
webbotywebboty

add-gmail

Integrate Gmail with NanoClaw for reading, sending, and email-triggered workflows.

Community
Advanced
leonj1leonj1

add-gmail

Integrate Gmail via MCP for reading and sending emails.

Community
Advanced
abhaymundharaabhaymundhara

add-gmail

Integrate Gmail with NanoClaw for WhatsApp-triggered email actions and email-triggered workflows.

Community
Advanced