Nopal

English | 한국어 | 中文 | 日本語 | Español

nopal
Google Workspace orchestration, powered by natural language.

Turn a plain sentence into a coordinated action across Gmail, Calendar, Drive, Docs, Sheets, Slides, Meet, Tasks, and Chat — all without leaving Claude Code.

Quick Start • Why nopal? • How it works • Services • Requirements

Quick Start

1. Add the marketplace (once)

2. Install nopal

Restart Claude Code after installation.

3. Set up gws CLI (once)

nopal uses gws CLI to talk to Google Workspace. Install it first:

Then run the one-time OAuth setup in your terminal:

This walks you through creating a GCP project, enabling the 9 Workspace APIs, and authorizing your Google account. After setup, log in:

After login, export credentials so Claude Code can use gws in headless mode:

4. Run

No arguments needed — nopal asks what you want. Or go directly:

Why nopal?

- One command, any service — describe what you want in plain language; nopal figures out which services to invoke and in what order
- Dynamic composition — not a fixed workflow library; services are selected and chained based on each request
- Interview-driven — if information is missing, nopal asks before acting (not after)
- Read vs. write distinction — read-only queries execute immediately; write and modify actions always get your confirmation first
- Lives in Claude Code — no new app, no browser tab, no context switch
- Credentials stay in gws — the gws CLI owns the OAuth flow. For headless use it exports tokens to a local ~/.config/gws/credentials.json (keep it chmod 600, never commit it); nopal never embeds credentials in Claude itself

How it works

Multi-service requests resolve naturally:

- "add attendees to tomorrow's meeting and send them the doc" → Calendar + Drive + Gmail
- "create a…