# google-calendar

Connects your coding agent to Google Calendar and Google Tasks. Lets you inspect schedules, plan appointments, and organize to-do items from the prompt.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 450 installs · ★ 3
- Author: dotneet
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/dotneet/claude-code-marketplace/tree/HEAD/google/skills/google-calendar/SKILL.md
- Updated: 2026-01-23
- HTML: https://affpapa.org/en/nevibecode/skills/dotneet-google-calendar

## What it does

This skill equips an agent with tools to interact with Google Calendar and Tasks APIs via bundled Python utilities. The assistant can search existing events, inspect free/busy windows, edit schedule entries, and track reminders across different tasklists.

Execution relies on the CLI script `gcal`. Timed items require RFC3339 timestamps, whereas full-day items use YYYY-MM-DD dates. Advanced operations like setting up attendee lists or custom conference configurations pass raw JSON via `--body` or `--body-file`. Switching accounts is handled by pointing `--token` or `GCAL_TOKEN_PATH` to separate files.

Setup requires a Desktop app OAuth credential file saved to `~/.config/google-calendar/credentials.json`. Without a configured Python virtual environment and an initial run of `gcal-auth`, the agent cannot issue API requests.

## Requirements
- Works with: Google Workspace

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add dotneet/claude-code-marketplace --skill google-calendar -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/google-calendar/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/google-calendar/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add dotneet/claude-code-marketplace --skill google-calendar -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/google-calendar/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add dotneet/claude-code-marketplace --skill google-calendar -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/google-calendar/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install dotneet/claude-code-marketplace google-calendar
```

2. **Manually: put the files in place**
- File: `.github/skills/google-calendar/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add dotneet/claude-code-marketplace --skill google-calendar -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/dotneet/claude-code-marketplace --path google/skills/google-calendar
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/google-calendar/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add dotneet/claude-code-marketplace --skill google-calendar -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/dotneet/claude-code-marketplace/tree/HEAD/google/skills/google-calendar/SKILL.md

## When to use it
- inspect attendee availability using free/busy lookups
- book a timed event directly on the primary calendar
- add a new task with a due date to Google Tasks
- delete or rename an existing calendar entry by its ID

## Example prompts
- Show all meetings on my primary calendar for today
- Schedule a 30-minute sync titled "Design Review" tomorrow at 2 PM
- Create a task named "Submit invoice" due by end of day in Google Tasks

## Similar
- [find-skills](https://affpapa.org/en/nevibecode/skills/find-skills.md) — skill · 4000000 installs
- [grill-me](https://affpapa.org/en/nevibecode/skills/grill-me.md) — skill · 1424476 installs
- [grill-with-docs](https://affpapa.org/en/nevibecode/skills/grill-with-docs.md) — skill · 1219756 installs
- [handoff](https://affpapa.org/en/nevibecode/skills/handoff.md) — skill · 1038491 installs
- [grilling](https://affpapa.org/en/nevibecode/skills/grilling.md) — skill · 979543 installs
- [teach](https://affpapa.org/en/nevibecode/skills/teach.md) — skill · 862247 installs

## Other versions with the same name
- [google-calendar · sanjay3290](https://affpapa.org/en/nevibecode/skills/google-calendar.md) — 536 installs
- [google-calendar · membranedev](https://affpapa.org/en/nevibecode/skills/membrane-google-calendar.md) — 337 installs

From the same set: [dotneet/claude-code-marketplace](https://affpapa.org/en/nevibecode/by/dotneet/claude-code-marketplace.md) — 6 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md