vamoose

Calendar workflows, minus the tedium.

The moose does the paperwork. You go to the beach.

Four calendar backends behind one workflow engine that branches, approves, waits, recurs, and files real leave with your HR system, driven from your terminal, Claude, Slack, or a local dashboard, and authorable by an AI agent over MCP. Every run is recorded, and the daemon resumes exactly where it left off after a crash. Install with brew install dcadolph/tap/vamoose.

Calendar busywork is death by a thousand cuts: create the hold marked free, invite your manager, Slack them for the yes, go back in and add the team one by one, add a second blocked event so your own calendar says away, then file the leave in the HR portal. vamoose turns those chores into workflows it runs for you and advances in the background. Time off is the flagship workflow, and you can define your own.

Two minutes to running

brew install dcadolph/tap/vamoose
vamoose login --provider google   # sign in; Outlook and iCloud setup in docs
vamoose off next week --watch     # hold the dates, invite your manager
vamoose daemon                    # advances the workflow when the manager accepts
vamoose app                       # or watch and run everything from a dashboard

That is the whole flow: the hold shows as free so it blocks nobody, your manager's calendar accept is the approval, and the daemon notifies your team the moment it lands.

How it works

1. Declare. A workflow is ordered steps in JSON: create a hold, gate on approval, branch on the outcome, wait, message a channel, file the leave. Time off ships built in; author your own in a file, on the dashboard's workflow canvas, or through an AI agent.
2. Run. Drive it from the terminal, Claude, Slack, or vamoose app, against Microsoft Graph, Google, iCloud, or any CalDAV host. Same workflow, any backend.
3. Advance. The daemon moves runs forward on its own: your manager accepting the invite is the approval signal (no separate approval product), timeouts and waits fire on the clock, recurring schedules re-run, and every step lands in the run history.

The built-in pto workflow is the flagship: hold shown free, manager approves by accepting, team added as optional attendees so nobody's calendar gets blocked. request, check, and promote are fronts over its steps. See Workflows.

Four backends ship behind one provider interface: Microsoft Graph (Outlook, Microsoft 365, and Teams), Google Calendar, Apple iCloud, and any standard CalDAV host. Pick one with --provider or the VAMOOSE_PROVIDER environment variable, and every command works the same across them. Approval detection is the one exception: iCloud sends invites but does not report accept/decline over CalDAV, so on iCloud you promote by hand. See providers.

Why not just calendar rules?

You can rig a version of this with one calendar's rules or a saved email. vamoose earns its keep the moment you have more than one account:

• One brain for every account. The same workflows, commands, and setup whether you are on Google, Outlook, or Microsoft 365. Learn it once, not once per client.
• No rebuilding per client. Native rules live inside one app and stop at its edge. Define a workflow once and point it at any backend with --provider.
• No drift. Change your time-off flow in one place. Hand-built rules drift the day you update Outlook and forget Gmail.
• Workflows are files, not clicks. JSON you can read, diff, share, version, and dry-run, instead of a settings panel you rebuild by hand on every machine.
• Runs where you already are. The CLI, Claude, and Slack, not one vendor's web UI.

Install

macOS and Linux:

brew install dcadolph/tap/vamoose

Windows:

scoop bucket add vamoose https://github.com/dcadolph/scoop-vamoose
scoop install vamoose

Docker (for hosting):

docker run --rm ghcr.io/dcadolph/vamoose:latest version

Or with Go 1.26 or newer:

go install github.com/dcadolph/vamoose@latest

Zips and tarballs for every platform are on the releases page.

New to vamoose? The Quickstart takes you from zero to a first approved hold in a few minutes.

Setup

Set one calendar backend and export its credentials, then run vamoose doctor to check the setup. Every backend, including iCloud and any CalDAV host, is covered in providers.

Microsoft 365 / Outlook

vamoose talks to Microsoft Graph as you, using the OAuth device-code flow.

1. Register an application in the Microsoft Entra admin center (single tenant is fine). Enable Allow public client flows so device code works.
2. Grant these delegated permissions and admin consent:
   • User.Read, User.Read.All (read your manager and their direct reports)
   • Calendars.ReadWrite (create and update the hold)
   • MailboxSettings.ReadWrite (reserved for the out-of-office reply)
   • offline_access (stay signed in between runs)
3. Export the settings:

export VAMOOSE_CLIENT_ID=<application-client-id>
export VAMOOSE_TENANT=<tenant-id-or-organizations>
export VAMOOSE_TIMEZONE=America/Chicago

The first command opens a device-code prompt. Tokens are cached under your user config directory and refreshed automatically after that. Run vamoose whoami first to confirm auth and directory access before creating any holds.

Google Calendar

For --provider google, create an OAuth desktop app client in the Google Cloud console, enable the Google Calendar API, then sign in:

export VAMOOSE_PROVIDER=google
export VAMOOSE_GOOGLE_CLIENT_ID=<oauth-desktop-client-id>
export VAMOOSE_GOOGLE_CLIENT_SECRET=<oauth-desktop-client-secret>
vamoose login

login opens your browser for consent on a local loopback address, then caches and refreshes tokens after that. Two things catch people out. Consent is denied until you add the signing-in account under Google Auth Platform, Audience, Test users. And while the app sits in Testing status, Google expires its refresh tokens after seven days, so login comes back around once a week. Both are covered step by step, with a troubleshooting table, in the Google guide.

Google Calendar has no directory, so pass your approver with --manager and set your team with vamoose team set.

Apple iCloud

For --provider icloud, create an app-specific password at appleid.apple.com and export:

export VAMOOSE_PROVIDER=icloud
export VAMOOSE_ICLOUD_USERNAME=you@icloud.com
export VAMOOSE_ICLOUD_APP_PASSWORD=xxxx-xxxx-xxxx-xxxx

iCloud sends invites but does not report approvals over CalDAV. Recover them with the macOS EventKit helper or a Slack Approve button, or promote by hand. See providers.

Any CalDAV host

For --provider caldav, point at any standard CalDAV server, such as Fastmail or Nextcloud:

export VAMOOSE_PROVIDER=caldav
export VAMOOSE_CALDAV_URL=https://caldav.fastmail.com
export VAMOOSE_CALDAV_USERNAME=you@fastmail.com
export VAMOOSE_CALDAV_PASSWORD=xxxx-xxxx-xxxx-xxxx

HR system, for balance and leave filing

Calendar setup is enough for holds, coverage, and approvals. Reading your remaining balance with vamoose balance, and filing approved time off as real leave, both need an HR system as well. Skip this section if you only want the calendar side.

Point at BambooHR directly:

export VAMOOSE_BAMBOOHR_SUBDOMAIN=<your-bamboohr-subdomain>
export VAMOOSE_BAMBOOHR_API_KEY=<bamboohr-api-key>
export VAMOOSE_BAMBOOHR_EMPLOYEE_ID=<your-employee-id>

Or post to any HR system through a webhook:

export VAMOOSE_BALANCE_WEBHOOK_URL=https://hr.example.com/balance
export VAMOOSE_LEAVE_WEBHOOK_URL=https://hr.example.com/leave
export VAMOOSE_HRIS_EMPLOYEE_ID=<your-employee-id>

Without one of these, vamoose balance exits reporting that no HR system is configured. Run vamoose doctor to see which parts are set.

Usage

# Confirm auth and directory access work in your tenant.
vamoose whoami

# Create the hold and invite your manager. Manager is resolved from the directory.
vamoose request --start 2026-07-20 --end 2026-07-24 --subject "Out: beach week"

# Or request time off from a plain-language phrase. It reports the working days,
# skipping weekends and configured holidays.
vamoose off next week --subject "Out: beach week"

# Just the afternoon.
vamoose off tomorrow --half pm

# Who else is off that week, and what do you have left?
vamoose coverage next week
vamoose balance

# See whether your manager has approved.
vamoose check

# Once approved, fan out to the team as optional attendees.
vamoose promote

# Changed plans? Cancel the hold and notify everyone.
vamoose cancel

# Or let check promote the moment approval lands.
vamoose check --promote

# Hands-off: watch for approval and let the daemon auto-promote in the background.
vamoose off next week --watch
vamoose daemon