Siri Shortcuts

Beanstats integrates with Siri and the Shortcuts app, allowing you to interact with the app via voice commands and automated workflows.

Available Shortcuts

Get Bean Inventory

Check your current coffee inventory.

Siri Phrases:

• “Check my coffee inventory in Beanstats”
• “What beans do I have in Beanstats”
• “How much coffee do I have in Beanstats”
• “What’s in my bag in Beanstats”

Returns: A text summary of your beans with remaining weights and low stock alerts.

Log Quick Espresso

Opens Beanstats with an espresso brew form. Review the recipe and tap Save in the app to log the shot.

Siri phrases:

• “Log an espresso in Beanstats”
• “Log a quick shot in Beanstats”
• “I pulled a shot with Beanstats”

Log Filter Brew

Opens the filter brew form. Enter or adjust the recipe and save it in the app.

Siri phrases:

• “Log a pour over in Beanstats”
• “Log a filter brew in Beanstats”
• “I made coffee in Beanstats”

Get Today’s Caffeine

Returns today’s estimated caffeine intake and the amount still active, using the same data and preferences as the caffeine dashboard. Runs without opening the app.

Try “Check my caffeine in Beanstats” or “How much caffeine have I had in Beanstats”.

Rate Brew

Rate a selected home brew, or your most recent one if none is selected, without opening the app.

Try “Rate my last brew in Beanstats”. Rating cancels any pending reminder for that brew and refreshes the Last Brew widget when applicable.

Repeat Last Brew

Say “Repeat my last brew in Beanstats” to open the form with your previous recipe prefilled. Review it, brew, and save in the app.

Export Last Brew as JSON

Export your most recent brew as JSON data.

Siri Phrases:

• “Export my last brew from Beanstats”
• “Get my last brew as JSON from Beanstats”

Parameters:

Returns: JSON string of the brew data for use in Shortcuts.

Export Specific Brew

Select and export a specific brew as JSON.

Parameters:

Creating Custom Shortcuts

Open the Shortcuts app and create automations using Beanstats actions:

Morning Inventory Check

Trigger: Time of day (7:00 AM)

1. Get Bean Inventory from Beanstats
2. Show the returned text in a notification

The inventory action returns a text summary, rather than a numeric weight to compare directly.

Open Espresso Form via NFC

Trigger: NFC tag scan

1. Run Log Quick Espresso from Beanstats
2. Complete the brew form in the app

Weekly Export

Trigger: Weekly (Sunday evening)

1. Export Last Brew as JSON from Beanstats
2. Save to Files app
3. Send via email or message

Spotlight Search

Search for beans and home brews from your device’s Spotlight search. Tap a result to open its details in Beanstats.

Tips

• Inventory, caffeine, rating, and JSON export actions can run without opening the app
• Espresso, filter, and repeat actions open a brew form; they do not silently save a brew
• Existing Shortcuts from 2.17.0 remain compatible with the stable identifiers introduced in 2.18.0
• Combine the returned text or JSON with other Shortcuts actions

URL Schemes

See URL Schemes for supported actions and version-specific limitations.

For advanced automation, Beanstats supports URL schemes that can be used in Shortcuts, Raycast, Alfred, and other tools:

Using URL Schemes in Shortcuts

1. Add a URL action with the scheme
2. Add an Open URLs action
3. The app opens to the specified location

Example: Quick Brew Button

Create a Shortcuts widget button:

1. New Shortcut
2. Add URL: beanstats://brew/new
3. Add Open URLs
4. Add to Home Screen