Skip to content

eduardoborges/meetfy

Repository files navigation

Meetfy

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

npm npm downloads


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

About

CLI for creating instant meetings and reserving time in Google Calendar.

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors