{"id":18862607,"url":"https://github.com/zk-phi/slack-to-gcal","last_synced_at":"2026-05-05T06:37:11.005Z","repository":{"id":152679708,"uuid":"235015681","full_name":"zk-phi/slack-to-gcal","owner":"zk-phi","description":"Slack slash command to manage Google Calendar events and tasks","archived":false,"fork":false,"pushed_at":"2021-03-01T03:30:56.000Z","size":75,"stargazers_count":1,"open_issues_count":1,"forks_count":0,"subscribers_count":3,"default_branch":"master","last_synced_at":"2024-12-30T21:15:20.708Z","etag":null,"topics":["gas","slack"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zk-phi.png","metadata":{"files":{"readme":"Readme.markdown","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-01-20T04:03:27.000Z","updated_at":"2021-06-29T04:12:28.000Z","dependencies_parsed_at":null,"dependency_job_id":"e7f564ae-c232-48f8-a73b-3e9695292e26","html_url":"https://github.com/zk-phi/slack-to-gcal","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zk-phi%2Fslack-to-gcal","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zk-phi%2Fslack-to-gcal/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zk-phi%2Fslack-to-gcal/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zk-phi%2Fslack-to-gcal/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zk-phi","download_url":"https://codeload.github.com/zk-phi/slack-to-gcal/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239808125,"owners_count":19700440,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["gas","slack"],"created_at":"2024-11-08T04:35:13.765Z","updated_at":"2026-02-10T15:30:18.321Z","avatar_url":"https://github.com/zk-phi.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# slack-to-gcal\n\nCRUD Google Calendar events from Slack.\n\n# Setup\n## Install `clasp`\n\nThis app can easily be deployed to your Google Drive with `clasp` (an official Google Apps Script API client).\n\nSee the repository page (https://github.com/google/clasp) for install instructions.\n\nAfter installing `clasp`, log-in to your Google account with `clasp login`.\n\n## Deploy the app to your Google Drive\n### Create an empty Google Apps Script item\n\nIn your Google Drive page, create a new item of the type `Google Apps Script` and copy the ID in its URL.\n\n```\nhttps://script.google.com/d/\u003cthe-app-id\u003e/edit\n```\n\nFOR SECURITY REASONS, YOU MUST NOT SHARE THE ITEM (especially with Edit permission) WITH OTHERS.\n\n### Deploy the app\n\nCreate a file named `.clasp.json` in the root directory of this repository, then register your app's ID as follows:\n\n```\n{\"scriptId\":\"\u003cthe-app-id\u003e\"}\n```\n\nAfter setting `scriptId`, you can use `clasp` to deploy the app.\n\n```\nclasp push   # upload the code\nclasp deploy # publish as a webapp\n```\n\nWhen the app is deployed, a public URL is given to the deployed app.\n\nIn the GAS app page, click `Publish` \u003e `Deploy as web app` and you'll see the URL. The URL will be used to connect to Slack later.\n\n## Connect Slack app to the GAS app\n### Create a Slack app\n\nOpen the Slack API page (https://api.slack.com/) and click `Your Apps` then `Create New App`.\n\n### Authorize the GAS app to use Slack APIs\n\nIn your Slack app page,\n\n- open `OAuth \u0026 Permissions` tab and copy the OAuth Access Token\n\nIn your GAS app page,\n\n- click `File` \u003e `Project Properties` \u003e `Script Properties` and add a property as follows:\n\n```\nKey: SLACK_ACCESS_TOKEN\nValue: \u003cthe Slack OAuth Access Token\u003e\n```\n\n### Enable interaction with the GAS app\n\nIn your Slack app page,\n\n- open `Interactivity \u0026 Shortcuts` tab and turn on the feature, then copy-and-paste the GAS app's public URL to the `Request URL` field\n\n- open `Basic Information` tab and copy the `Verification Token` in `App Credentials` section\n\nIn your GAS app page,\n\n- click `File` \u003e `Project Properties` \u003e `Script Properties` and add a property as follows:\n\n```\nKey: SLACK_VERIFICATION_TOKEN\nValue: \u003cthe Slack Verification Token\u003e\n```\n\n### Add a slash command or a shortcut to the Slack app\n\nIn your Slack app page, either (or both):\n\n- open `Slash Commands` tab and turn on the feature, then create a new command and copy-and-paste the GAS app's public URL to the `Request URL` field\n\n- open `Interactivity \u0026 Shortcuts` tab and create two new shortcuts with callback id `add` and `add_task` respectively\n\n### Add an incoming webhook to the Slack app\n\nIn your Slack app page,\n\n- open `Incoming Webhooks` tab and turn on the feature, then click `Add New Webhook to Workspace`\n\nIn your GAS app page,\n\n- click `File` \u003e `Project Properties` \u003e `Script Properties` and add a property as follows:\n\n```\nKey: SLACK_WEBHOOKURL\nValue: \u003cthe Slack webhook URL created in the Slack app page\u003e\n```\n\n## Authorize the GAS app to use Google APIs\n\nOpen `main.gs` in the GAS app page and run `doHelp` function manually from the menu `Execute` \u003e `Execute a function` \u003e `doHelp`.\n\nYou'll be asked to permit the app to use Google Calendar API, Tasks API and outgoing hooks.\n\nAfter authorization, a help text will be posted to your Slack channel.\n\n## Completed !\n\nNow you can create Google Calendar events via the Slack slash command as follows:\n\n```\n/task Meet the brewers 12/30\n```\n\n```\n/task Vacation 8/1-31\n```\n\n# Development\n\nWhen you modify the app and want to update the deployment, you can use `-i` option to redeploy without changing the public URL. If `-i` is omitted, you'll have multiple deployments with different versions, in different URLs.\n\n```\nclasp push\nclasp deploy -i \u003cdeployment ID\u003e\n```\n\nYou can see the list of deployments with `clasp deployments`:\n\n```\n$ clasp deployments\n2 Deployments.\n- \u003cdev deployment ID\u003e @HEAD\n- \u003cdeployment ID\u003e @4\n```\n\nThe first deployment tagged `@HEAD` is a read-only deployment for dev use, which always runs the latest version of the app. So you'll usually want to redeploy the second deployment.\n\nAfter creating unneeded deployments, you can also delete the deployment with `clasp undeploy \u003cID\u003e` command.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzk-phi%2Fslack-to-gcal","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzk-phi%2Fslack-to-gcal","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzk-phi%2Fslack-to-gcal/lists"}