Meetfy

CLI for creating instant meetings and reserving time in Google Calendar. No credentials file on your machine — auth via hosted OAuth.

---

Install

npm install -g meetfy

Or with pnpm:

pnpm add -g meetfy

Usage

First time: authenticate

Sign in with Google (opens the browser and uses the hosted Auth Worker — no local credentials):

meetfy auth

Create a meeting

Creates an instant meeting and reserves 30 minutes in your calendar. Asks for title, description, and participants if not passed.

meetfy create

With options (no prompts):

meetfy create --title "Sync with team" --description "Weekly sync"
meetfy create -t "1:1" -d "Catch up" -p "alice@example.com,bob@example.com"

See your next meeting

meetfy next

Log out

meetfy logout

JSON output

Use --json for scriptable output (auth, create, next).

meetfy --json auth
meetfy --json create --title "Standup"
meetfy --json next

Example (create success):

{"success":true,"meeting":{"title":"Standup","hangoutLink":"https://meet.google.com/...","startTime":"...","endTime":"..."}}

Example (not authenticated):

{"success":false,"error":"auth_required"}

Commands

Command	Description
meetfy auth	Authenticate with Google Calendar (opens browser)
meetfy create	Create an instant meeting (30 min) and reserve time
meetfy next	Show your next scheduled meeting
meetfy logout	Log out from Google

Options (global)

Option	Description
--json	Output result as JSON (for scripts)

Options (create)

Option	Short	Description
--title <title>	-t	Meeting title
--description <description>	-d	Meeting description
--participants <emails>	-p	Comma-separated participant emails

Requirements

• Node.js ≥ 22

License

ISC