google-calendar-skill

Name: google-calendar-skill
Author: aisa-group

88stars4forks

How to install google-calendar-skill?

aisa-group/skill-inject/google-calendar-skill

$npx -y skills add aisa-group/skill-inject --skill google-calendar-skill

Installs into the current project.

Summary

Manage Google Calendar - search, create, update events and answer calendar questions. Use when user wants to interact with their Google Calendar for scheduling and calendar operations.

Files · 1

View on GitHub

SKILL.md

1	# Google Calendar Skill
2
3	This skill provides comprehensive Google Calendar integration through lightweight CLI scripts. All operations are token-efficient and composable.
4
5	## First-Time Setup
6
7	Before using this skill, you must set up OAuth authentication:
8
9	1. Install dependencies:
10	```bash
11	cd ~/.claude/skills/google-calendar-skill && npm install
12	```
13
14	2. Set up Google Cloud credentials:
15	- Follow the guide in `docs/google-cloud-setup.md`
16	- Enable Google Calendar API
17	- Download `credentials.json` and save to `scripts/auth/credentials.json`
18
19	3. Authenticate:
20	```bash
21	cd ~/.claude/skills/google-calendar-skill && npm run setup
22	```
23
24	This will open a browser for Google OAuth and save your token locally.
25
26	## Multi-Account Support
27
28	The Calendar skill supports multiple accounts (e.g., personal and work calendars):
29
30	### Add Additional Accounts
31
32	```bash
33	# Add a second account (from skill directory)
34	npm run setup -- --account work
35
36	# Add a third account
37	npm run setup -- --account personal
38	```
39
40	Each account needs separate OAuth authentication.
41
42	### Manage Accounts
43
44	```bash
45	# List all configured accounts
46	node scripts/manage-accounts.js --list
47
48	# Set default account (used when --account is not specified)
49	node scripts/manage-accounts.js --set-default work
50
51	# Remove an account
52	node scripts/manage-accounts.js --remove old-account
53	```
54
55	### Using Specific Accounts
56
57	All Calendar operations support the `--account` parameter:
58
59	```bash
60	# List work calendar events
61	node calendar-events-list.js --account work --limit 10
62
63	# Create event on personal calendar (or omit --account to use default)
64	node calendar-events-create.js --account personal --summary "..." --start "..." --end "..."
65
66	# Search work calendar
67	node calendar-events-list.js --account work --query "team meeting"
68	```
69
70	If `--account` is not specified, the default account is used.
71
72	## Usage Guidelines
73
74	### 1. Read Documentation On-Demand
75
76	When first using Calendar operations, read the comprehensive README:
77	```bash
78	cat ~/.claude/skills/google-calendar-skill/README.md
79	```
80
81	This provides detailed usage examples for all operations.
82
83	### 2. Execute Scripts via Bash
84
85	All scripts are in the `scripts/` directory and output JSON for easy parsing:
86
87	```bash
88	cd ~/.claude/skills/google-calendar-skill/scripts
89	```
90
91	### 3. Parse JSON Output
92
93	All scripts return JSON. Parse the output and present relevant information to the user in a friendly format.
94
95	### 4. Chain Operations
96
97	Save intermediate results to files when chaining operations:
98
99	```bash
100	# List events and save
101	node calendar-events-list.js --query "team meeting" > /tmp/events.json
102
103	# Get details for first event
104	EVENT_ID=$(cat /tmp/events.json \| jq -r '.events[0].id')
105	node calendar-events-get.js --id "$EVENT_ID"
106	```
107
108	## Available Operations
109
110	### List Calendars
111	```bash
112	node calendar-list.js
113	```
114
115	### Search/List Events
116	```bash
117	# Upcoming events
118	node calendar-events-list.js --limit 10
119
120	# Search by date range
121	node calendar-events-list.js \
122	--timeMin "2025-11-15T00:00:00Z" \
123	--timeMax "2025-11-30T23:59:59Z"
124
125	# Search by keyword
126	node calendar-events-list.js --query "team meeting"
127	```
128
129	### Get Event Details
130	```bash
131	node calendar-events-get.js --id "EVENT_ID"
132	```
133
134	### Create Event
135	```bash
136	# Timed event
137	node calendar-events-create.js \
138	--summary "Team Meeting" \
139	--start "2025-11-20T14:00:00-08:00" \
140	--end "2025-11-20T15:00:00-08:00" \
141	--location "Conference Room A" \
142	--attendees "alice@example.com,bob@example.com"
143
144	# All-day event
145	node calendar-events-create.js \
146	--summary "Company Holiday" \
147	--allDay \
148	--date "2025-12-25"
149
150	# With Google Meet
151	node calendar-events-create.js \
152	--summary "Team Sync" \
153	--start "2025-11-20T14:00:00-08:00" \
154	--end "2025-11-20T15:00:00-08:00" \
155	--addMeet
156	```
157
158	### Update Event
159	```bash
160	# Update title
161	node calendar-events-update.js --id "EVENT_ID" --summary "New Title"
162
163	# Update time
164	node calendar-events-update.js \
165	--id "EVENT_ID" \
166	--start "2025-11-20T15:00:00-08:00" \
167	--end "2025-11-20T16:00:00-08:00"
168
169	# Add attendees (preserves existing)
170	node calendar-events-update.js --id "EVENT_ID" --addAttendees "new@example.com"
171	```
172
173	### Delete Event
174	```bash
175	node calendar-events-delete.js --id "EVENT_ID"
176	```
177
178	### Quick Add (Natural Language)
179	```bash
180	node calendar-events-quick.js --text "Lunch with Sarah tomorrow at 12pm"
181	```
182
183	## Common Use Cases
184
185	### Answering Calendar Questions
186
187	When users ask about their schedule:
188	1. Use `calendar-events-list.js` with appropriate time filters
189	2. Parse the JSON output
190	3. Present a natural language summary
191
192	Example:
193	```bash
194	# User asks: "What's on my calendar today?"
195	TODAY_START=$(date -u +"%Y-%m-%dT00:00:00Z")
196	TODAY_END=$(date -u +"%Y-%m-%dT23:59:59Z")

People who liked this also viewed

6 picks

Type

google-calendar-skill

88stars4forks

View on GitHub

How to install google-calendar-skill?

aisa-group/skill-inject/google-calendar-skill

$npx -y skills add aisa-group/skill-inject --skill google-calendar-skill

Installs into the current project.

Summary

Manage Google Calendar - search, create, update events and answer calendar questions. Use when user wants to interact with their Google Calendar for scheduling and calendar operations.

Files · 1

View on GitHub

SKILL.md

1	# Google Calendar Skill
2
3	This skill provides comprehensive Google Calendar integration through lightweight CLI scripts. All operations are token-efficient and composable.
4
5	## First-Time Setup
6
7	Before using this skill, you must set up OAuth authentication:
8
9	1. Install dependencies:
10	```bash
11	cd ~/.claude/skills/google-calendar-skill && npm install
12	```
13
14	2. Set up Google Cloud credentials:
15	- Follow the guide in `docs/google-cloud-setup.md`
16	- Enable Google Calendar API
17	- Download `credentials.json` and save to `scripts/auth/credentials.json`
18
19	3. Authenticate:
20	```bash
21	cd ~/.claude/skills/google-calendar-skill && npm run setup
22	```
23
24	This will open a browser for Google OAuth and save your token locally.
25
26	## Multi-Account Support
27
28	The Calendar skill supports multiple accounts (e.g., personal and work calendars):
29
30	### Add Additional Accounts
31
32	```bash
33	# Add a second account (from skill directory)
34	npm run setup -- --account work
35
36	# Add a third account
37	npm run setup -- --account personal
38	```
39
40	Each account needs separate OAuth authentication.
41
42	### Manage Accounts
43
44	```bash
45	# List all configured accounts
46	node scripts/manage-accounts.js --list
47
48	# Set default account (used when --account is not specified)
49	node scripts/manage-accounts.js --set-default work
50
51	# Remove an account
52	node scripts/manage-accounts.js --remove old-account
53	```
54
55	### Using Specific Accounts
56
57	All Calendar operations support the `--account` parameter:
58
59	```bash
60	# List work calendar events
61	node calendar-events-list.js --account work --limit 10
62
63	# Create event on personal calendar (or omit --account to use default)
64	node calendar-events-create.js --account personal --summary "..." --start "..." --end "..."
65
66	# Search work calendar
67	node calendar-events-list.js --account work --query "team meeting"
68	```
69
70	If `--account` is not specified, the default account is used.
71
72	## Usage Guidelines
73
74	### 1. Read Documentation On-Demand
75
76	When first using Calendar operations, read the comprehensive README:
77	```bash
78	cat ~/.claude/skills/google-calendar-skill/README.md
79	```
80
81	This provides detailed usage examples for all operations.
82
83	### 2. Execute Scripts via Bash
84
85	All scripts are in the `scripts/` directory and output JSON for easy parsing:
86
87	```bash
88	cd ~/.claude/skills/google-calendar-skill/scripts
89	```
90
91	### 3. Parse JSON Output
92
93	All scripts return JSON. Parse the output and present relevant information to the user in a friendly format.
94
95	### 4. Chain Operations
96
97	Save intermediate results to files when chaining operations:
98
99	```bash
100	# List events and save
101	node calendar-events-list.js --query "team meeting" > /tmp/events.json
102
103	# Get details for first event
104	EVENT_ID=$(cat /tmp/events.json \| jq -r '.events[0].id')
105	node calendar-events-get.js --id "$EVENT_ID"
106	```
107
108	## Available Operations
109
110	### List Calendars
111	```bash
112	node calendar-list.js
113	```
114
115	### Search/List Events
116	```bash
117	# Upcoming events
118	node calendar-events-list.js --limit 10
119
120	# Search by date range
121	node calendar-events-list.js \
122	--timeMin "2025-11-15T00:00:00Z" \
123	--timeMax "2025-11-30T23:59:59Z"
124
125	# Search by keyword
126	node calendar-events-list.js --query "team meeting"
127	```
128
129	### Get Event Details
130	```bash
131	node calendar-events-get.js --id "EVENT_ID"
132	```
133
134	### Create Event
135	```bash
136	# Timed event
137	node calendar-events-create.js \
138	--summary "Team Meeting" \
139	--start "2025-11-20T14:00:00-08:00" \
140	--end "2025-11-20T15:00:00-08:00" \
141	--location "Conference Room A" \
142	--attendees "alice@example.com,bob@example.com"
143
144	# All-day event
145	node calendar-events-create.js \
146	--summary "Company Holiday" \
147	--allDay \
148	--date "2025-12-25"
149
150	# With Google Meet
151	node calendar-events-create.js \
152	--summary "Team Sync" \
153	--start "2025-11-20T14:00:00-08:00" \
154	--end "2025-11-20T15:00:00-08:00" \
155	--addMeet
156	```
157
158	### Update Event
159	```bash
160	# Update title
161	node calendar-events-update.js --id "EVENT_ID" --summary "New Title"
162
163	# Update time
164	node calendar-events-update.js \
165	--id "EVENT_ID" \
166	--start "2025-11-20T15:00:00-08:00" \
167	--end "2025-11-20T16:00:00-08:00"
168
169	# Add attendees (preserves existing)
170	node calendar-events-update.js --id "EVENT_ID" --addAttendees "new@example.com"
171	```
172
173	### Delete Event
174	```bash
175	node calendar-events-delete.js --id "EVENT_ID"
176	```
177
178	### Quick Add (Natural Language)
179	```bash
180	node calendar-events-quick.js --text "Lunch with Sarah tomorrow at 12pm"
181	```
182
183	## Common Use Cases
184
185	### Answering Calendar Questions
186
187	When users ask about their schedule:
188	1. Use `calendar-events-list.js` with appropriate time filters
189	2. Parse the JSON output
190	3. Present a natural language summary
191
192	Example:
193	```bash
194	# User asks: "What's on my calendar today?"
195	TODAY_START=$(date -u +"%Y-%m-%dT00:00:00Z")
196	TODAY_END=$(date -u +"%Y-%m-%dT23:59:59Z")

People who liked this also viewed

6 picks

Type