{"id":"47012823-c326-452f-ba0e-172c67bf6381","shortId":"nk7YEs","kind":"skill","title":"gws-calendar","tagline":"Google Calendar: Manage calendars and events.","description":"# calendar (v3)\n\n> **PREREQUISITE:** Read `../gws-shared/SKILL.md` for auth, global flags, and security rules. If missing, run `gws generate-skills` to create it.\n\n```bash\ngws calendar <resource> <method> [flags]\n```\n\n## Helper Commands\n\n| Command | Description |\n|---------|-------------|\n| [`+insert`](../gws-calendar-insert/SKILL.md) | create a new event |\n| [`+agenda`](../gws-calendar-agenda/SKILL.md) | Show upcoming events across all calendars |\n\n## API Resources\n\n### acl\n\n  - `delete` — Deletes an access control rule.\n  - `get` — Returns an access control rule.\n  - `insert` — Creates an access control rule.\n  - `list` — Returns the rules in the access control list for the calendar.\n  - `patch` — Updates an access control rule. This method supports patch semantics.\n  - `update` — Updates an access control rule.\n  - `watch` — Watch for changes to ACL resources.\n\n### calendarList\n\n  - `delete` — Removes a calendar from the user's calendar list.\n  - `get` — Returns a calendar from the user's calendar list.\n  - `insert` — Inserts an existing calendar into the user's calendar list.\n  - `list` — Returns the calendars on the user's calendar list.\n  - `patch` — Updates an existing calendar on the user's calendar list. This method supports patch semantics.\n  - `update` — Updates an existing calendar on the user's calendar list.\n  - `watch` — Watch for changes to CalendarList resources.\n\n### calendars\n\n  - `clear` — Clears a primary calendar. This operation deletes all events associated with the primary calendar of an account.\n  - `delete` — Deletes a secondary calendar. Use calendars.clear for clearing all events on primary calendars.\n  - `get` — Returns metadata for a calendar.\n  - `insert` — Creates a secondary calendar.\nThe authenticated user for the request is made the data owner of the new calendar.\n\nNote: We recommend to authenticate as the intended data owner of the calendar. You can use domain-wide delegation of authority to allow applications to act on behalf of a specific user. Don't use a service account for authentication. If you use a service account for authentication, the service account is the data owner, which can lead to unexpected behavior.\n  - `patch` — Updates metadata for a calendar. This method supports patch semantics.\n  - `update` — Updates metadata for a calendar.\n\n### channels\n\n  - `stop` — Stop watching resources through this channel\n\n### colors\n\n  - `get` — Returns the color definitions for calendars and events.\n\n### events\n\n  - `delete` — Deletes an event.\n  - `get` — Returns an event based on its Google Calendar ID. To retrieve an event using its iCalendar ID, call the events.list method using the iCalUID parameter.\n  - `import` — Imports an event. This operation is used to add a private copy of an existing event to a calendar. Only events with an eventType of default may be imported.\nDeprecated behavior: If a non-default event is imported, its type will be changed to default and any event-type-specific properties it may have will be dropped.\n  - `insert` — Creates an event.\n  - `instances` — Returns instances of the specified recurring event.\n  - `list` — Returns events on the specified calendar.\n  - `move` — Moves an event to another calendar, i.e. changes an event's organizer. Note that only default events can be moved; birthday, focusTime, fromGmail, outOfOffice and workingLocation events cannot be moved.\n  - `patch` — Updates an event. This method supports patch semantics.\n  - `quickAdd` — Creates an event based on a simple text string.\n  - `update` — Updates an event.\n  - `watch` — Watch for changes to Events resources.\n\n### freebusy\n\n  - `query` — Returns free/busy information for a set of calendars.\n\n### settings\n\n  - `get` — Returns a single user setting.\n  - `list` — Returns all user settings for the authenticated user.\n  - `watch` — Watch for changes to Settings resources.\n\n## Discovering Commands\n\nBefore calling any API method, inspect it:\n\n```bash\n# Browse resources and methods\ngws calendar --help\n\n# Inspect a method's required params, types, and defaults\ngws schema calendar.<resource>.<method>\n```\n\nUse `gws schema` output to build your `--params` and `--json` flags.","tags":["gws","calendar","cli","googleworkspace","agent-skills","ai-agent","automation","discovery-api","gemini-cli-extension","google-admin","google-api","google-calendar"],"capabilities":["skill","source-googleworkspace","skill-gws-calendar","topic-agent-skills","topic-ai-agent","topic-automation","topic-cli","topic-discovery-api","topic-gemini-cli-extension","topic-google-admin","topic-google-api","topic-google-calendar","topic-google-chat","topic-google-docs","topic-google-drive"],"categories":["cli"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/googleworkspace/cli/gws-calendar","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add googleworkspace/cli","source_repo":"https://github.com/googleworkspace/cli","install_from":"skills.sh"}},"qualityScore":"0.700","qualityRationale":"deterministic score 0.70 from registry signals: · indexed on github topic:agent-skills · 26371 github stars · SKILL.md body (4,181 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-18T18:52:29.242Z","embedding":null,"createdAt":"2026-04-18T20:24:19.854Z","updatedAt":"2026-05-18T18:52:29.242Z","lastSeenAt":"2026-05-18T18:52:29.242Z","tsv":"'/gws-calendar-agenda/skill.md':47 '/gws-calendar-insert/skill.md':41 '/gws-shared/skill.md':14 'access':60,66,72,81,90,101 'account':205,284,292,297 'acl':56,109 'across':51 'act':272 'add':383 'agenda':46 'allow':269 'anoth':458 'api':54,552 'applic':270 'associ':198 'auth':16 'authent':232,250,286,294,538 'author':267 'base':352,497 'bash':32,556 'behalf':274 'behavior':307,405 'birthday':474 'brows':557 'build':581 'calendar':3,5,7,10,34,53,86,115,120,125,130,136,141,146,151,157,162,173,178,187,192,202,210,219,225,230,245,258,313,324,340,356,393,452,459,523,562,575 'calendarlist':111,185 'calendars.clear':212 'call':366,550 'cannot':481 'chang':107,183,418,461,510,543 'channel':325,332 'clear':188,189,214 'color':333,337 'command':37,38,548 'control':61,67,73,82,91,102 'copi':386 'creat':30,42,70,227,435,494 'data':240,254,300 'default':400,410,420,469,572 'definit':338 'deleg':265 'delet':57,58,112,195,206,207,344,345 'deprec':404 'descript':39 'discov':547 'domain':263 'domain-wid':262 'drop':433 'event':9,45,50,197,216,342,343,347,351,361,377,390,395,411,424,437,445,448,456,463,470,480,487,496,506,512 'event-type-specif':423 'events.list':368 'eventtyp':398 'exist':135,156,172,389 'flag':18,35,586 'focustim':475 'free/busy':517 'freebusi':514 'fromgmail':476 'generat':27 'generate-skil':26 'get':63,122,220,334,348,525 'global':17 'googl':4,355 'gws':2,25,33,561,573,577 'gws-calendar':1 'help':563 'helper':36 'i.e':460 'icalendar':364 'icaluid':372 'id':357,365 'import':374,375,403,413 'inform':518 'insert':40,69,132,133,226,434 'inspect':554,564 'instanc':438,440 'intend':253 'json':585 'lead':304 'list':75,83,121,131,142,143,152,163,179,446,531 'made':238 'manag':6 'may':401,429 'metadata':222,310,321 'method':94,165,315,369,489,553,560,566 'miss':23 'move':453,454,473,483 'new':44,244 'non':409 'non-default':408 'note':246,466 'oper':194,379 'organ':465 'outofoffic':477 'output':579 'owner':241,255,301 'param':569,583 'paramet':373 'patch':87,96,153,167,308,317,484,491 'prerequisit':12 'primari':191,201,218 'privat':385 'properti':427 'queri':515 'quickadd':493 'read':13 'recommend':248 'recur':444 'remov':113 'request':236 'requir':568 'resourc':55,110,186,329,513,546,558 'retriev':359 'return':64,76,123,144,221,335,349,439,447,516,526,532 'rule':21,62,68,74,78,92,103 'run':24 'schema':574,578 'secondari':209,229 'secur':20 'semant':97,168,318,492 'servic':283,291,296 'set':521,524,530,535,545 'show':48 'simpl':500 'singl':528 'skill':28 'skill-gws-calendar' 'source-googleworkspace' 'specif':277,426 'specifi':443,451 'stop':326,327 'string':502 'support':95,166,316,490 'text':501 'topic-agent-skills' 'topic-ai-agent' 'topic-automation' 'topic-cli' 'topic-discovery-api' 'topic-gemini-cli-extension' 'topic-google-admin' 'topic-google-api' 'topic-google-calendar' 'topic-google-chat' 'topic-google-docs' 'topic-google-drive' 'type':415,425,570 'unexpect':306 'upcom':49 'updat':88,98,99,154,169,170,309,319,320,485,503,504 'use':211,261,281,289,362,370,381,576 'user':118,128,139,149,160,176,233,278,529,534,539 'v3':11 'watch':104,105,180,181,328,507,508,540,541 'wide':264 'workingloc':479","prices":[{"id":"2f8345c4-da83-448b-9676-7d34e1c3fa33","listingId":"47012823-c326-452f-ba0e-172c67bf6381","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"googleworkspace","category":"cli","install_from":"skills.sh"},"createdAt":"2026-04-18T20:24:19.854Z"}],"sources":[{"listingId":"47012823-c326-452f-ba0e-172c67bf6381","source":"github","sourceId":"googleworkspace/cli/gws-calendar","sourceUrl":"https://github.com/googleworkspace/cli/tree/main/skills/gws-calendar","isPrimary":false,"firstSeenAt":"2026-04-18T21:51:45.688Z","lastSeenAt":"2026-05-18T18:52:29.242Z"},{"listingId":"47012823-c326-452f-ba0e-172c67bf6381","source":"skills_sh","sourceId":"googleworkspace/cli/gws-calendar","sourceUrl":"https://skills.sh/googleworkspace/cli/gws-calendar","isPrimary":true,"firstSeenAt":"2026-04-18T20:24:19.854Z","lastSeenAt":"2026-05-07T22:40:14.327Z"}],"details":{"listingId":"47012823-c326-452f-ba0e-172c67bf6381","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"googleworkspace","slug":"gws-calendar","github":{"repo":"googleworkspace/cli","stars":26371,"topics":["agent-skills","ai-agent","automation","cli","discovery-api","gemini-cli-extension","google-admin","google-api","google-calendar","google-chat","google-docs","google-drive","google-sheets","google-workspace","oauth2","rust"],"license":"apache-2.0","html_url":"https://github.com/googleworkspace/cli","pushed_at":"2026-05-12T16:46:11Z","description":"Google Workspace CLI — one command-line tool for Drive, Gmail, Calendar, Sheets, Docs, Chat, Admin, and more. Dynamically built from Google Discovery Service. Includes AI agent skills.","skill_md_sha":"08e134ce7c2167ec0284f6f09bca5ee8d66eb7bd","skill_md_path":"skills/gws-calendar/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/googleworkspace/cli/tree/main/skills/gws-calendar"},"layout":"multi","source":"github","category":"cli","frontmatter":{"name":"gws-calendar","description":"Google Calendar: Manage calendars and events."},"skills_sh_url":"https://skills.sh/googleworkspace/cli/gws-calendar"},"updatedAt":"2026-05-18T18:52:29.242Z"}}