skills.rest
spyqs
spyqsCOMMUNITY
Explore all skills by this author →
GitHub

add-gmail

Add OAuth-backed Gmail integration to NanoClaw for email tooling or inbox-triggered responses.

Updated Mar 15, 2026
Search Tags:#oauth#mcp#email automation#gmail#container#agent channels#nodejs integration
One-click install
npx skills add https://github.com/spyqs/nanoclaw-email-imap --skill add-gmail-spyqs
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: add-gmail
Source: https://github.com/spyqs/nanoclaw-email-imap/tree/main/.claude/skills/add-gmail
Command: npx skills add https://github.com/spyqs/nanoclaw-email-imap --skill add-gmail-spyqs

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires googleapis.

What problem does it solve?

This Skill helps you add Gmail integration to NanoClaw so an agent can read, send, and search emails—either only when invoked as tools or by actively monitoring your inbox as a channel.

Core Features & Use Cases

  • Tool-only Gmail integration: Enables agent actions like reading, drafting, sending, and searching emails without polling the inbox.
  • Full channel mode: Adds an inbox listener that can trigger agent responses to incoming email notifications while keeping the behavior controlled.
  • GCP OAuth setup & verification: Guides you through creating OAuth credentials, authorizing access, mounting credentials, and restarting the agent runner.

Quick Start

Tell your NanoClaw agent to run the add-gmail skill and follow the prompts to choose tool-only or channel mode.

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 Node.js agent for reading and sending email?▼

Gmail integration is achieved by mounting OAuth credentials and enabling a Gmail MCP server for the agent. This allows the agent to read, send, search, and draft emails using the googleapis library.

Can I trigger automated agent responses from incoming Gmail messages?▼

Yes, you can configure a full channel mode that polls your Primary inbox for notifications. This inbox listener actively triggers agent responses to incoming emails while keeping behavior controlled.

What is the difference between tool-only and channel mode for email automation?▼

Tool-only mode enables on-demand agent actions like reading and sending emails without polling. Channel mode adds an inbox listener that automatically triggers agent responses to incoming email notifications.

Do I need OAuth credentials to connect Gmail to my agent runner?▼

Yes, OAuth-backed Gmail access is required for the integration to function. You must create GCP OAuth credentials, authorize access, and mount the ~/.gmail-mcp credentials file before restarting the agent runner.

How do I verify that Gmail MCP server integration is working correctly?▼

You verify the Gmail MCP server integration by running build and test checks alongside log checks. This ensures the OAuth credentials are mounted correctly and the agent can successfully access Gmail.

Why is my Gmail integration not triggering agent responses to new emails?▼

If agent responses are not triggering, the integration is likely configured for tool-only mode rather than full channel mode. Channel mode is required to add an inbox listener that polls for incoming email notifications.

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
zhaosj0315zhaosj0315

add-gmail

Integrate Gmail into NanoClaw for reading and sending emails via OAuth.

Community
Advanced
sskarzsskarz
2

add-gmail

Integrate Gmail into NanoClawbster with OAuth and the Gmail MCP server.

Community
Advanced
abhaymundharaabhaymundhara

add-gmail

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

Community
Advanced