google-workspace

Manage Google Calendar events, Google Tasks, and publish project timelines to Google Docs.

9|Updated Jul 8, 2026
One-click install
npx skills add https://github.com/jerrylin96/dotgemini --skill google-workspace-jerrylin96
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: google-workspace
Source: https://github.com/jerrylin96/dotgemini/tree/main/skills/google-workspace
Command: npx skills add https://github.com/jerrylin96/dotgemini --skill google-workspace-jerrylin96

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires google-api-python-client, google-auth, and includes scripts (resource) components.

What problem does it solve? Coordinating project schedules across Google Calendar, Google Tasks, and stakeholder documents requires manual cross-referencing of free time, task creation, and status reporting. This Skill automates that workflow by managing calendar events and tasks directly and by decomposing goals into conflict-free scheduled timelines. ## Core Features & Use Cases - Calendar & Tasks CRUD: List, create, update, and delete Google Calendar events and Google Tasks via the Google APIs using Application Default Credentials. - Timeline Planner: Decompose a goals.json file into a proposed timeline, find free slots within working hours around existing calendar events, provision task lists and focus blocks, track completion status, and generate weekly sprint rollups. - Google Docs Publishing: Publish the proposed timeline to a shared Google Doc, append revisions or postmortems, and share it with stakeholders at reader, commenter, or writer roles. - Use Case: Given a two-week project plan with subtasks and durations, generate a proposed_timeline.md that avoids existing meetings, review it, then apply it to create the TaskList, tasks, and Focus calendar blocks in one flow. ## Quick Start Ask the agent to list your calendar events for the next 7 days and create a task due Friday using the google-workspace skill.

Frequently Asked Questions about google-workspace

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a Google Calendar event from the command line?

Run workspace_client.py with the calendar create subcommand, passing --title, --start, and --end in ISO 8601 format with a timezone offset. The script uses Google Application Default Credentials to insert the event on the primary calendar.

How do I schedule a project plan around existing calendar meetings?

Define tasks and durations in a goals.json file, then run timeline_planner.py plan to generate proposed_timeline.md with free slots inside your working hours. After reviewing the markdown, run the apply command to create the Google Tasks and Focus calendar blocks.

What authentication does the Google Calendar and Tasks integration need?

It uses Google Application Default Credentials obtained via gcloud auth application-default login with cloud-platform, calendar, tasks, documents, and drive.file scopes. Run the auth-check command to verify the credentials work before other operations.

Can Google Tasks have nested subtasks?

Google Tasks supports at most one level of nesting, so subtasks cannot contain their own subtasks. The planner rejects goals.json entries with nested grandchild tasks and ignores parent-level duration_hours when subtasks are present.

Why does timeline parsing fail on my proposed_timeline.md?

The parser relies on indentation: parent tasks need less than 2 characters of indent, subtasks at least 2, and subtask properties at least 4. Missing required sections like Metadata, Proposed Google Tasks, or Proposed Calendar Events also cause validation errors.