{"id":"47012823-c326-452f-ba0e-172c67bf6381","shortId":"nk7YEs","kind":"skill","title":"Gws Calendar","tagline":"Cli skill by Googleworkspace","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"],"capabilities":["skill","source-googleworkspace","category-cli"],"categories":["cli"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/googleworkspace/cli/gws-calendar","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"install_from":"skills.sh"}},"qualityScore":"0.300","qualityRationale":"deterministic score 0.30 from registry signals: · indexed on skills.sh · published under googleworkspace/cli","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:v1","enrichmentVersion":1,"enrichedAt":"2026-04-22T08:40:08.766Z","embedding":null,"createdAt":"2026-04-18T20:24:19.854Z","updatedAt":"2026-04-22T08:40:08.766Z","lastSeenAt":"2026-04-22T08:40:08.766Z","tsv":"'/gws-calendar-agenda/skill.md':44 '/gws-calendar-insert/skill.md':38 '/gws-shared/skill.md':11 'access':57,63,69,78,87,98 'account':202,281,289,294 'acl':53,106 'across':48 'act':269 'add':380 'agenda':43 'allow':266 'anoth':455 'api':51,549 'applic':267 'associ':195 'auth':13 'authent':229,247,283,291,535 'author':264 'base':349,494 'bash':29,553 'behalf':271 'behavior':304,402 'birthday':471 'brows':554 'build':578 'calendar':2,7,31,50,83,112,117,122,127,133,138,143,148,154,159,170,175,184,189,199,207,216,222,227,242,255,310,321,337,353,390,449,456,520,559,572 'calendarlist':108,182 'calendars.clear':209 'call':363,547 'cannot':478 'category-cli' 'chang':104,180,415,458,507,540 'channel':322,329 'clear':185,186,211 'cli':3 'color':330,334 'command':34,35,545 'control':58,64,70,79,88,99 'copi':383 'creat':27,39,67,224,432,491 'data':237,251,297 'default':397,407,417,466,569 'definit':335 'deleg':262 'delet':54,55,109,192,203,204,341,342 'deprec':401 'descript':36 'discov':544 'domain':260 'domain-wid':259 'drop':430 'event':42,47,194,213,339,340,344,348,358,374,387,392,408,421,434,442,445,453,460,467,477,484,493,503,509 'event-type-specif':420 'events.list':365 'eventtyp':395 'exist':132,153,169,386 'flag':15,32,583 'focustim':472 'free/busy':514 'freebusi':511 'fromgmail':473 'generat':24 'generate-skil':23 'get':60,119,217,331,345,522 'global':14 'googl':352 'googleworkspac':6 'gws':1,22,30,558,570,574 'help':560 'helper':33 'i.e':457 'icalendar':361 'icaluid':369 'id':354,362 'import':371,372,400,410 'inform':515 'insert':37,66,129,130,223,431 'inspect':551,561 'instanc':435,437 'intend':250 'json':582 'lead':301 'list':72,80,118,128,139,140,149,160,176,443,528 'made':235 'may':398,426 'metadata':219,307,318 'method':91,162,312,366,486,550,557,563 'miss':20 'move':450,451,470,480 'new':41,241 'non':406 'non-default':405 'note':243,463 'oper':191,376 'organ':462 'outofoffic':474 'output':576 'owner':238,252,298 'param':566,580 'paramet':370 'patch':84,93,150,164,305,314,481,488 'prerequisit':9 'primari':188,198,215 'privat':382 'properti':424 'queri':512 'quickadd':490 'read':10 'recommend':245 'recur':441 'remov':110 'request':233 'requir':565 'resourc':52,107,183,326,510,543,555 'retriev':356 'return':61,73,120,141,218,332,346,436,444,513,523,529 'rule':18,59,65,71,75,89,100 'run':21 'schema':571,575 'secondari':206,226 'secur':17 'semant':94,165,315,489 'servic':280,288,293 'set':518,521,527,532,542 'show':45 'simpl':497 'singl':525 'skill':4,25 'source-googleworkspace' 'specif':274,423 'specifi':440,448 'stop':323,324 'string':499 'support':92,163,313,487 'text':498 'type':412,422,567 'unexpect':303 'upcom':46 'updat':85,95,96,151,166,167,306,316,317,482,500,501 'use':208,258,278,286,359,367,378,573 'user':115,125,136,146,157,173,230,275,526,531,536 'v3':8 'watch':101,102,177,178,325,504,505,537,538 'wide':261 'workingloc':476","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-04-22T06:52:34.876Z"},{"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-04-22T08:40:08.766Z"}],"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","source":"skills_sh","category":"cli","skills_sh_url":"https://skills.sh/googleworkspace/cli/gws-calendar"},"updatedAt":"2026-04-22T08:40:08.766Z"}}