Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/iloveitaly/calendly-cli
Get available calendly times via the command line for easy copy/paste into email
https://github.com/iloveitaly/calendly-cli
calendly calendly-api scheduling
Last synced: about 1 month ago
JSON representation
Get available calendly times via the command line for easy copy/paste into email
- Host: GitHub
- URL: https://github.com/iloveitaly/calendly-cli
- Owner: iloveitaly
- License: mit
- Created: 2022-02-16T14:22:06.000Z (almost 3 years ago)
- Default Branch: master
- Last Pushed: 2024-11-02T12:00:17.000Z (2 months ago)
- Last Synced: 2024-11-02T13:16:33.155Z (2 months ago)
- Topics: calendly, calendly-api, scheduling
- Language: Python
- Homepage:
- Size: 200 KB
- Stars: 0
- Watchers: 2
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: readme.md
- License: LICENSE
Awesome Lists containing this project
README
# Calendly on the Command Line
## Why?
I had a specific problem I wanted to solve:
* Lots of scheduling emails each day
* Scheduling emails between more than one party. Normally, I'd just send my calendly link, but that doesn't work well with groups of people.
* I *hate* finding open times in my calendar, especially if I'm sending multiple time options to multiple people. It's weirdly time consuming for me, mainly because I have complex "rules" for calendaring to coordinate between family life, day-job, personal committments, and side projects.
The solution? A CLI tool to spit out a bunch of open times in my calendar.
## Implementation Details
There are some specific features I wanted:
* Exclude weekend times
* Easily select times in a different timezone
* Command line interface so I can easily connect to Alfred/Raycast
* Pick a "nice" list of times: semi-randomized, across multiple days, etc to allow the receiver to have a nice array of options
## Usage
```
Usage: cli.py [OPTIONS]
Generate time options based off of a calendly account
Options:
--duration INTEGER Number of minutes to schedule [default: 30]
--days INTEGER Number of days in advance to pick from [default:
30]
--timezone TEXT Default timezone to pick times from [default:
America/Denver]
--after-hour INTEGER Only pick events after this hour (24hr format)
--total INTEGER Number of slots per event [default: 5]
--events INTEGER Number of events to schedule [default: 3]
--slots-per-day INTEGER Number of slots per day [default: 3]
--api-key TEXT API key. Sourced from CALENDLY_API_KEY as well
--help Show this message and exit.
```
## Development
```shell
poetry install
poetry shell
# either use ipython with `run main.py` to play around with the code
ipython
# or run the command directly and start tinkering
```
#### API Hacking
You can play with the calendly API using [httpie](https://httpie.io) really easily.
```shell
source .env
http GET https://api.calendly.com/users/me Authorization:"Bearer $CALENDLY_API_KEY" Content-Type:application/json
```
The `"current_organization"` key contains the org URL which doesn't seem to be exposed in the UI at all (at least on basic accounts).