google-workspace-cli 0.1.0__py3-none-any.whl

google_workspace_cli-0.1.0.dist-info/METADATA

@@ -0,0 +1,270 @@
+Metadata-Version: 2.4
+Name: google-workspace-cli
+Version: 0.1.0
+Summary: Google Workspace CLI for Claude Code — Calendar, Gmail, Drive with multi-account OAuth support
+Project-URL: Homepage, https://github.com/JFK/gw-cli
+Project-URL: Repository, https://github.com/JFK/gw-cli
+Project-URL: Issues, https://github.com/JFK/gw-cli/issues
+Author-email: Fumikazu Kiyota <fumikazu.kiyota@gmail.com>
+License: MIT
+License-File: LICENSE
+Keywords: calendar,claude-code,cli,gmail,google-drive,google-workspace,multi-account,oauth2
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Communications :: Email
+Classifier: Topic :: Office/Business :: Scheduling
+Requires-Python: >=3.10
+Requires-Dist: click>=8.3
+Requires-Dist: google-api-python-client>=2.194
+Requires-Dist: google-auth-oauthlib>=1.3
+Requires-Dist: google-auth>=2.49
+Requires-Dist: rich>=15.0
+Requires-Dist: tzdata>=2024.1; platform_system == 'Windows'
+Description-Content-Type: text/markdown
+
+# gw-cli
+
+[![PyPI version](https://img.shields.io/pypi/v/google-workspace-cli.svg)](https://pypi.org/project/google-workspace-cli/)
+[![Python versions](https://img.shields.io/pypi/pyversions/google-workspace-cli.svg)](https://pypi.org/project/google-workspace-cli/)
+[![License: MIT](https://img.shields.io/pypi/l/google-workspace-cli.svg)](https://github.com/JFK/gw-cli/blob/master/LICENSE)
+[![CI](https://github.com/JFK/gw-cli/actions/workflows/ci.yml/badge.svg)](https://github.com/JFK/gw-cli/actions/workflows/ci.yml)
+
+> **Google Workspace CLI for Claude Code — manage Calendar, Gmail, and Drive across multiple Google accounts.**
+
+`gw-cli` is a [Claude Code](https://claude.com/claude-code) plugin that brings Google Workspace into your terminal. Register multiple OAuth accounts, switch between them instantly, and let Claude Code operate your calendar, email, and files through natural language.
+
+## 60-second quickstart
+
+```text
+# In any Claude Code session:
+/plugin marketplace add JFK/gw-cli
+/plugin install gw-cli
+
+# Setup (one-time):
+gw auth login --credentials ./credentials.json
+
+# Then use naturally:
+"Show me my unread emails"
+"Schedule a meeting tomorrow at 10am with Meet"
+"What's on my calendar this week?"
+```
+
+## Features
+
+- **Multi-account support** — Register multiple Google accounts (personal, work, client projects) and switch between them instantly
+- **Calendar** — List, create, update, delete events. Google Meet setup. Free/busy check across accounts
+- **Gmail** — Search, read, send, reply. Label management. Mark read/unread. Attachment download and save to Drive
+- **Drive** — List, search, upload, create Google Docs/Sheets/Slides. Share/unshare files
+- **Claude Code integration** — All commands support `--json` output for seamless skill parsing
+- **Periodic monitoring** — Use with `/loop` for unread email checks, calendar reminders
+- **WSL2 compatible** — Automatic fallback to manual OAuth flow when localhost callback is unreachable
+
+## Required dependencies
+
+| Tool | Required | Why |
+|---|---|---|
+| Python 3.10+ | yes | Runtime |
+| `pip` | yes | Package installation |
+| `gcloud` CLI | recommended | GCP project setup and API enablement |
+| [Claude Code](https://claude.com/claude-code) | recommended | Plugin integration and natural language interface |
+
+## Install
+
+### As a Claude Code plugin (recommended)
+
+```text
+/plugin marketplace add JFK/gw-cli
+/plugin install gw-cli
+```
+
+The plugin auto-installs the Python CLI and registers 7 skills:
+
+| Skill | Description |
+|---|---|
+| `/gw-setup` | Guided first-time Google Cloud setup |
+| `/gw-auth` | Account management (login, switch, list, remove) |
+| `/gw-calendar` | Calendar operations |
+| `/gw-mail` | Gmail operations |
+| `/gw-drive` | Drive operations |
+| `/gw-workflow` | Cross-service workflows (email attachment to Drive, etc.) |
+| `/gw-loop` | Periodic monitoring setup |
+
+### Standalone CLI
+
+```bash
+pip install google-workspace-cli
+```
+
+> Published on PyPI as **`google-workspace-cli`** (the `gw-cli` name was already taken). The installed command is still `gw`.
+
+Latest from source:
+
+```bash
+pip install git+https://github.com/JFK/gw-cli.git
+```
+
+Or clone and install locally:
+
+```bash
+git clone https://github.com/JFK/gw-cli.git
+cd gw-cli
+pip install -e .
+```
+
+## Setup
+
+### 1. Create GCP Project
+
+```bash
+gcloud projects create gw-cli-$(date +%Y%m%d) --name="gw-cli"
+gcloud config set project gw-cli-YYYYMMDD
+```
+
+### 2. Enable APIs
+
+```bash
+gcloud services enable calendar-json.googleapis.com gmail.googleapis.com drive.googleapis.com --project=PROJECT_ID
+```
+
+### 3. OAuth Consent Screen
+
+Open in browser: `https://console.cloud.google.com/apis/credentials/consent?project=PROJECT_ID`
+
+- User Type: **External**
+- App name: `gw-cli`
+- Add your email as a **test user** (required, otherwise login fails with 403)
+
+### 4. Create OAuth Client
+
+Open in browser: `https://console.cloud.google.com/apis/credentials/oauthclient?project=PROJECT_ID`
+
+- Application type: **Desktop app**
+- Download the JSON file
+
+### 5. Login
+
+```bash
+gw auth login --credentials ./credentials.json
+```
+
+On WSL2/remote environments, the tool automatically falls back to manual URL paste mode when the localhost callback is unreachable.
+
+### 6. Verify
+
+```bash
+gw auth status
+gw cal list --days 3
+gw mail list --query "is:unread" --limit 5
+```
+
+## Usage
+
+### Available commands
+
+```
+gw auth     login, list, status, switch, remove
+gw cal      list, get, create, update, delete, free
+gw mail     list, read, send, reply, labels, label, mark, attachments, download, to-drive
+gw drive    list, upload, create, share, unshare
+gw config   show, set
+```
+
+### Calendar
+
+```bash
+gw cal list --days 7
+gw cal create --title "Meeting" --start "2026-04-17 10:00" --end "2026-04-17 11:00" --meet
+gw cal create --title "1on1" --start "2026-04-18 14:00" --end "2026-04-18 14:30" --meet --attendee colleague@example.com
+gw cal free --date 2026-04-17
+gw cal delete EVENT_ID
+```
+
+### Gmail
+
+```bash
+gw mail list --query "is:unread"
+gw mail read MESSAGE_ID
+gw mail send --to "user@example.com" --subject "Hello" --body "Hi there"
+gw mail reply MESSAGE_ID --body "Thanks!"
+gw mail mark MESSAGE_ID --read
+gw mail attachments MESSAGE_ID
+gw mail to-drive MESSAGE_ID --attachment-id ATT_ID --folder FOLDER_ID
+```
+
+### Drive
+
+```bash
+gw drive list
+gw drive list --query "name contains 'report'"
+gw drive upload ./file.pdf
+gw drive create --type doc --title "New Document"
+gw drive share FILE_ID --email user@example.com --role writer
+gw drive unshare FILE_ID --email user@example.com
+```
+
+### Multi-account
+
+```bash
+gw auth login --credentials ./work-credentials.json    # Add another account
+gw auth list                                            # Show all accounts
+gw auth switch work@company.com                         # Switch active account
+gw mail list                                            # Uses active account
+gw mail list --account personal@gmail.com               # Override for one command
+```
+
+### Config
+
+```bash
+gw config show
+gw config set defaults.calendar.days 14
+gw config set defaults.mail.limit 50
+```
+
+## Output
+
+All commands support `--json` for machine-readable output:
+
+```bash
+gw cal list --json
+gw mail list --query "is:unread" --json
+```
+
+Human-readable output always shows the active account:
+
+```
+[fumikazu.kiyota@gmail.com]
+  evt1 | Team standup | 2026-04-17T10:00:00+09:00 | ...
+```
+
+## Periodic Monitoring
+
+Use with the `/loop` skill for continuous monitoring:
+
+```
+/loop 5m gw mail list --query "is:unread" --json
+/loop 30m gw cal list --days 1 --json
+```
+
+## Config storage
+
+Config stored at `~/.config/google-workspace-cli/config.json`.
+
+Credentials and tokens are stored per account:
+
+```
+~/.config/google-workspace-cli/
+├── config.json
+├── credentials/
+│   └── user@gmail.com.json
+└── tokens/
+    └── user@gmail.com.json
+```
+
+## License
+
+MIT

google_workspace_cli-0.1.0.dist-info/RECORD

@@ -0,0 +1,13 @@
+gw/__init__.py,sha256=kUR5RAFc7HCeiqdlX36dZOHkUI5wI6V_43RpEcD8b-0,22
+gw/auth.py,sha256=tovl1N7FNcg1SJWqe3FfOO3vBus81O8k6iXoaRIQYIg,7287
+gw/calendar.py,sha256=5RIXyiasVRqIfDWhiJzg5XDo5NA0Ey4E7bGHQ-Ab1RQ,8823
+gw/cli.py,sha256=at8JikU302isNawNgxzC0azCKrHrIzRECyC4Ee0gzpk,3424
+gw/config.py,sha256=IjKG6eILcRxgwUEVGWzjNSNqx5LZOjm_7fXpENIN0Ko,4226
+gw/drive.py,sha256=INdU6NZ8RdMs0DKg9QMb0AD4iyQKSCKhzPruVET6cwU,6387
+gw/gmail.py,sha256=BPUuyxnlyNTBzOI2UMtkWRozQ96duZA6fy6ll0_GHUs,13299
+gw/output.py,sha256=c0RYrnvgIXftMuwTFZnRdYTBLMkAPHUFKyANvSRsB1Y,833
+google_workspace_cli-0.1.0.dist-info/METADATA,sha256=eCy8gE4Nv_0vxdJ58yOgEUjTsw53XPyw3X5SMQQ0r1Q,8151
+google_workspace_cli-0.1.0.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
+google_workspace_cli-0.1.0.dist-info/entry_points.txt,sha256=TZgF92FFR2flxwiXWddhth8EI3AxYdIMdEPnBHQgkZ4,34
+google_workspace_cli-0.1.0.dist-info/licenses/LICENSE,sha256=ESYyLizI0WWtxMeS7rGVcX3ivMezm-HOd5WdeOh-9oU,1056
+google_workspace_cli-0.1.0.dist-info/RECORD,,

google_workspace_cli-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.30.1
+Root-Is-Purelib: true
+Tag: py3-none-any

google_workspace_cli-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+gw = gw.cli:cli

google_workspace_cli-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

gw/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.1.0"

gw/auth.py

@@ -0,0 +1,199 @@
+from __future__ import annotations
+
+import os
+import shutil
+import sys
+from pathlib import Path
+
+import click
+from google_auth_oauthlib.flow import InstalledAppFlow
+from googleapiclient.discovery import build
+
+from gw.config import DEFAULT_CONFIG_DIR, GwConfig
+
+SCOPES = [
+    "https://www.googleapis.com/auth/calendar",
+    "https://www.googleapis.com/auth/gmail.modify",
+    "https://www.googleapis.com/auth/gmail.send",
+    "https://www.googleapis.com/auth/drive",
+]
+
+
+def _can_auto_open_browser() -> bool:
+    """Whether auto-opening a browser is likely to reach the user.
+
+    On WSL2 and headless hosts the OS default URL handler is usually wrong (e.g. a
+    file manager) or absent, so an auto-opened consent page never appears. In those
+    cases the caller should skip the auto-open and let the operator open the printed
+    URL in any browser that can reach this host's localhost (a Windows browser
+    reaches WSL2 localhost). On native desktops (macOS / Windows / Linux with a
+    display) auto-open is the convenient one-step path.
+    """
+    if os.environ.get("WSL_DISTRO_NAME"):
+        return False
+    try:
+        with open("/proc/version", encoding="utf-8") as fh:
+            if "microsoft" in fh.read().lower():
+                return False
+    except OSError:
+        pass
+    if sys.platform.startswith("linux") and not (os.environ.get("DISPLAY") or os.environ.get("WAYLAND_DISPLAY")):
+        return False
+    return True
+
+
+def _get_user_email(credentials) -> str:
+    """Fetch the authenticated user's email via Gmail API."""
+    service = build("gmail", "v1", credentials=credentials)
+    profile = service.users().getProfile(userId="me").execute()
+    return profile["emailAddress"]
+
+
+def _resolve_config_dir(ctx: click.Context, config_dir: Path | None) -> Path:
+    """Resolve config_dir from subcommand option, parent context, or default."""
+    if config_dir is not None:
+        return config_dir
+    return ctx.obj.get("config_dir", DEFAULT_CONFIG_DIR)
+
+
+_config_dir_option = click.option(
+    "--config-dir",
+    type=click.Path(path_type=Path),
+    default=None,
+    hidden=True,
+    help="Config directory (default: ~/.config/google-workspace-cli)",
+)
+
+
+@click.group()
+@click.pass_context
+def auth(ctx: click.Context) -> None:
+    """Manage Google accounts."""
+    ctx.ensure_object(dict)
+
+
+@auth.command()
+@click.option("--credentials", required=True, type=click.Path(exists=True, path_type=Path))
+@_config_dir_option
+@click.pass_context
+def login(ctx: click.Context, credentials: Path, config_dir: Path | None) -> None:
+    """Add a Google account via OAuth login."""
+    resolved_dir = _resolve_config_dir(ctx, config_dir)
+    cfg = GwConfig(resolved_dir)
+
+    flow = InstalledAppFlow.from_client_secrets_file(str(credentials), SCOPES)
+
+    try:
+        # Loopback flow. Always print the consent URL explicitly (don't rely on
+        # the library's default prompt message) and keep the local server
+        # listening long enough for the operator to authorize. Only auto-open a
+        # browser where one is likely to reach the user: on WSL2/headless the OS
+        # default URL handler is often wrong (e.g. a file manager), so we skip the
+        # auto-open and let the operator open the printed URL in any browser that
+        # can reach this host's localhost (a Windows browser reaches WSL2 localhost).
+        flow.run_local_server(
+            port=0,
+            open_browser=_can_auto_open_browser(),
+            authorization_prompt_message=("\nOpen this URL in your browser to authorize:\n\n{url}\n"),
+            timeout_seconds=300,
+        )
+    except Exception:
+        # Last-resort manual paste (requires an interactive terminal for the prompt).
+        auth_url, _ = flow.authorization_url(prompt="consent")
+        click.echo(f"\nOpen this URL in your browser:\n\n{auth_url}\n")
+        click.echo("After authorizing, you will be redirected to a localhost URL.")
+        click.echo("Copy the FULL URL from the browser address bar and paste it here:\n")
+        redirect_url = click.prompt("Redirect URL")
+        flow.fetch_token(authorization_response=redirect_url)
+
+    creds = flow.credentials
+    email = _get_user_email(creds)
+
+    dest_creds = cfg.credentials_dir / f"{email}.json"
+    cfg.credentials_dir.mkdir(parents=True, exist_ok=True)
+    shutil.copy2(credentials, dest_creds)
+    os.chmod(dest_creds, 0o600)
+
+    cfg.tokens_dir.mkdir(parents=True, exist_ok=True)
+    token_path = cfg.tokens_dir / f"{email}.json"
+    token_path.write_text(creds.to_json())
+    os.chmod(token_path, 0o600)
+
+    cfg.add_account(email, f"credentials/{email}.json")
+    click.echo(f"Logged in as {email}")
+
+
+@auth.command("list")
+@_config_dir_option
+@click.pass_context
+def list_accounts(ctx: click.Context, config_dir: Path | None) -> None:
+    """List registered accounts."""
+    resolved_dir = _resolve_config_dir(ctx, config_dir)
+    cfg = GwConfig(resolved_dir)
+    if not cfg.accounts:
+        click.echo("No accounts registered. Run 'gw auth login' to add one.")
+        return
+    for acct in cfg.accounts:
+        marker = " *" if acct["email"] == cfg.active_account else ""
+        click.echo(f"  {acct['email']}{marker}")
+
+
+@auth.command()
+@_config_dir_option
+@click.pass_context
+def status(ctx: click.Context, config_dir: Path | None) -> None:
+    """Show the active account."""
+    resolved_dir = _resolve_config_dir(ctx, config_dir)
+    cfg = GwConfig(resolved_dir)
+    if cfg.active_account:
+        click.echo(f"Active account: {cfg.active_account}")
+    else:
+        click.echo("No active account. Run 'gw auth login' to add one.")
+
+
+@auth.command()
+@click.argument("email")
+@_config_dir_option
+@click.pass_context
+def switch(ctx: click.Context, email: str, config_dir: Path | None) -> None:
+    """Switch the active account."""
+    resolved_dir = _resolve_config_dir(ctx, config_dir)
+    cfg = GwConfig(resolved_dir)
+    cfg.switch_account(email)
+    click.echo(f"Switched to {email}")
+
+
+@auth.command()
+@click.argument("email")
+@_config_dir_option
+@click.pass_context
+def remove(ctx: click.Context, email: str, config_dir: Path | None) -> None:
+    """Remove a registered account."""
+    resolved_dir = _resolve_config_dir(ctx, config_dir)
+    cfg = GwConfig(resolved_dir)
+    cfg.remove_account(email)
+    click.echo(f"Removed {email}")
+
+
+def build_service(cfg: GwConfig, email: str, api_name: str, api_version: str):
+    """Build an authenticated Google API service for the given account."""
+    from google.auth.transport.requests import Request
+    from google.oauth2.credentials import Credentials
+
+    token_path = cfg.get_token_path(email)
+    if not token_path.exists():
+        raise RuntimeError(f"No token found for {email}. Run 'gw auth login --credentials <path>' first.")
+
+    creds = Credentials.from_authorized_user_file(str(token_path), SCOPES)
+
+    if creds.expired and creds.refresh_token:
+        try:
+            creds.refresh(Request())
+            token_path.write_text(creds.to_json())
+            os.chmod(token_path, 0o600)
+        except Exception as exc:
+            raise RuntimeError(
+                f"Token refresh failed for {email}. Run 'gw auth login --credentials <path>' to re-authenticate."
+            ) from exc
+
+    return build(api_name, api_version, credentials=creds)