skills.rest
hellosimplerick
hellosimplerickCOMMUNITY
Explore all skills by this author →
GitHub

add-gmail

Integrate Gmail into NanoClaw with OAuth and MCP tools.

Updated Aug 23, 2026
Search Tags:#automation#oauth#mcp#gmail#container#email-channel#googleapis
One-click install
npx skills add https://github.com/hellosimplerick/nanoclaw-smoke --skill add-gmail-hellosimplerick
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: add-gmail
Source: https://github.com/hellosimplerick/nanoclaw-smoke/tree/main/.claude/skills/add-gmail
Command: npx skills add https://github.com/hellosimplerick/nanoclaw-smoke --skill add-gmail-hellosimplerick

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

NanoClaw lacks native email integration, so users cannot reliably surface incoming emails to the assistant, automate email-based workflows, or send replies from agent context without manual configuration and risky ad-hoc scripts. This Skill centralizes Gmail access, handling OAuth setup, container mounts, and tool/channel registration so agents can safely read, send, and react to email messages.

Core Features & Use Cases

  • Tool-only mode: Provide read, search, draft, and send Gmail tools to agents without adding inbox polling or channel code. Ideal when you want manual, on-demand email actions.
  • Channel mode: Poll the Primary inbox and deliver incoming emails into the main group as notifications that can trigger automated tasks or scheduled workflows.
  • Secure OAuth & persistence: Guides the user through GCP OAuth client creation, stores credentials in ~/.gmail-mcp, mounts that directory into containers for token refresh, and persists refreshed tokens.
  • Container and MCP integration: Adds a Gmail MCP server for mcp__gmail__* tools, updates container mounts and agent-runner tooling, and includes tests and manifest changes to ensure deterministic application.
  • Use case: Automatically notify a team channel when high-priority emails arrive and allow the agent to reply or perform actions when explicitly instructed.

Quick Start

Ask NanoClaw to run the add-gmail skill, follow the guided GCP OAuth setup, and choose whether incoming emails should automatically trigger the agent.

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 an agent to read and send emails?▼

You integrate Gmail by using this Skill to register a Gmail MCP server that exposes mcp__gmail__* tools, allowing agents to read, search, draft, and send emails through OAuth-based authentication with GCP credentials.

Can I trigger automated agent actions from incoming emails?▼

Yes, you can trigger automated agent actions from incoming emails by enabling Channel mode, which polls the Primary inbox and delivers incoming emails as notifications to trigger automated tasks or scheduled workflows.

How does OAuth authentication work for Gmail in isolated containers?▼

OAuth authentication for Gmail in isolated containers works by storing GCP credentials in ~/.gmail-mcp and mounting that directory into the containers for secure token persistence and automatic token refresh.

Do I need GCP OAuth credentials to use Gmail automation?▼

Yes, GCP OAuth credentials are required for Gmail automation. The Skill guides you through GCP OAuth client creation to securely authorize container access for reading, searching, and sending emails.

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

Tool-only mode provides on-demand read, search, draft, and send Gmail tools without polling, while Channel mode actively polls the Primary inbox to deliver incoming emails as notifications that trigger automated agent workflows.

Related Skills

Explore More Software Engineering Skills→
gunabotgunabot
7

add-gmail

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

Community
Advanced
leonj1leonj1

add-gmail

Integrate Gmail via MCP for reading and sending emails.

Community
Advanced
devMoezdevMoez
1

native-mcp

Connect Titan Agent to MCP servers and register discovered tools.

Community
Advanced
JOHNNYWHITEMIKEJOHNNYWHITEMIKE

mcporter

List, authenticate, configure, and invoke MCP servers and tools via mcporter CLI.

Community
Intermediate