add-gmail

Integrate Gmail with NanoClaw for automated email reading, sending, and replying.

7|Updated Feb 2, 2026
One-click install
npx skills add https://github.com/gunabot/nanoclaw --skill add-gmail-gunabot
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: add-gmail
Source: https://github.com/gunabot/nanoclaw/tree/main/.claude/skills/add-gmail
Command: npx skills add https://github.com/gunabot/nanoclaw --skill add-gmail-gunabot

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill integrates Gmail capabilities with NanoClaw to enable email-based automation and channel-enabled workflows, reducing context switching and manual steps.

Core Features & Use Cases

  • Tool Mode: Agent can read and send emails when triggered from WhatsApp.
  • Channel Mode: Emails can trigger the agent, schedule tasks, and receive replies.
  • Setup Guide: Guided through Google Cloud OAuth credentials setup and Gmail MCP integration for secure access and operation.
  • Use Case: For example, automatically check unread messages or compose responses based on WhatsApp prompts.

Quick Start

  1. Decide between Tool Mode or Channel Mode.
  2. Configure Gmail access by creating a Google Cloud project, enabling the Gmail API, and downloading credentials to gcp-oauth.keys.json in the home directory (e.g., ~/.gmail-mcp).
  3. Run the Gmail authorization: npx -y @gongrzhe/server-gmail-autoauth-mcp auth and complete the browser flow.
  4. Verify access with a quick test and trigger a simple task from WhatsApp to confirm Gmail actions.

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 NanoClaw for automated email workflows?

Gmail integration with NanoClaw is configured via OAuth credentials and a Gmail MCP backend to automate reading, sending, and replying to emails. You must create a Google Cloud project, enable the Gmail API, and mount the downloaded credentials in the container.

Can I trigger an agent from incoming emails and send automatic replies?

Yes, you can trigger an agent from incoming emails and send automatic replies using Channel Mode. This mode allows emails to initiate agent tasks, schedule workflows, and generate responses without manual intervention.

How do I set up Gmail OAuth credentials for an automated agent?

To set up Gmail OAuth credentials, you create a Google Cloud project, enable the Gmail API, and download the keys to a file. You then run the authorization command in your terminal to complete the browser login flow and verify access.

What is the difference between Tool Mode and Channel Mode for Gmail automation?

Tool Mode allows an agent to read and send emails only when triggered from another channel like WhatsApp. Channel Mode enables incoming emails to directly trigger the agent, schedule tasks, and receive replies autonomously.

Do I need to install a Gmail MCP backend to manage email events and routing?

Yes, installing and wiring the Gmail MCP backend is required. It manages email events, routing, and responses within the container, and you must update the agent runner to expose the Gmail tools.

Why does my Gmail integration require updating the agent runner?

Updating the agent runner is required to expose Gmail tools to the NanoClaw agent. This wiring step ensures the OAuth credentials are mounted correctly and the Gmail MCP backend can manage events and routing.