Skip to main content
Glama
meticulous-mcp

meticulous-mcp

by NatiCha

meticulous-mcp

MCP server for controlling Meticulous espresso machines via Claude and other AI clients.

Installation

Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "meticulous": {
      "command": "npx",
      "args": ["-y", "meticulous-mcp"]
    }
  }
}

Related MCP server: claude-sessions-mcp

Configuration

Environment Variable

Default

Description

METICULOUS_URL

http://meticulousimaginativeflavorprofile.local

Your machine's URL

Available Tools

Machine

  • get_device_info - Get device information (firmware, serial, etc.)

  • get_status - Get current machine status (temperatures, pressures)

  • get_settings - Get machine settings

  • update_setting - Update a machine setting

  • execute_action - Execute machine actions

Profiles

  • list_profiles - List all profiles

  • get_profile - Get profile details

  • load_profile - Load a profile for brewing

  • get_last_profile - Get the last used profile

  • save_profile - Create or update a profile

  • get_profile_schema - Get the JSON schema for profiles

Brewing

  • start_brew - Start brewing with current profile

  • stop_brew - Stop the current brew

  • tare_scale - Tare the scale

  • preheat - Start preheating

  • reset_machine - Reset the machine

History

  • search_shot_history - Search shot history

  • get_shot_details - Get details of a specific shot

  • get_last_shot - Get the most recent shot

  • get_current_shot - Get current shot in progress

  • get_history_stats - Get brewing statistics

  • rate_shot - Rate a shot

Usage with Other Projects

The tools can be imported for use in other projects:

import { registerMCPTools, type ToolContext } from "meticulous-mcp/tools"

License

MIT

Available Tools

22 tools
execute_actionC

Execute an action on the machine such as start brewing, stop, tare the scale, or preheat

Inputs: action (required).

get_current_shotA

Get information about the currently brewing shot. Returns brewing status and live data if a shot is in progress.

Inputs: no named parameters.

get_device_infoA

Get information about the connected Meticulous espresso machine including model, firmware version, serial number, and build info

Inputs: no named parameters.

get_history_statsA

Get aggregate statistics about your espresso shots including total shots and usage by profile

Inputs: no named parameters.

get_last_profileA

Get the profile that was most recently loaded, including when it was loaded

Inputs: no named parameters.

get_last_shotA

Get summary information about the most recent espresso shot. Returns metadata and profile info without full timeseries. Use get_shot_details with the returned ID for full data.

Inputs: no named parameters.

get_profileA

Get the full details of a specific espresso profile including all extraction parameters and steps

Inputs: profile_id (required).

get_profile_schemaA

Get the JSON schema for creating custom espresso extraction profiles. Use this to understand the structure before creating a new profile with save_profile.

Inputs: no named parameters.

get_settingsA

Get current machine settings including auto preheat, sounds, timezone, and other configurable parameters

Inputs: no named parameters.

get_shot_detailsA

Get full details for a specific shot by ID, including complete timeseries data (pressure, flow, weight, temperature over time). Use search_shot_history first to find shot IDs.

Inputs: shot_id (required).

get_statusA

Get the current real-time status of the machine including sensor data (pressure, flow, weight, temperature), machine state (idle/brewing/etc), and current profile

Inputs: no named parameters.

list_profilesA

List all saved espresso extraction profiles with their names and basic info

Inputs: no named parameters.

load_profileA

Load a specific profile to be used for the next espresso extraction. The machine will use these settings when brewing starts.

Inputs: profile_id (required).

preheatA

Start preheating the group head to the target temperature. This helps ensure consistent extraction temperatures.

Inputs: no named parameters.

rate_shotA

Rate a shot as like or dislike, or remove the rating

Inputs: shot_id (required), rating (required).

reset_machineA

Reset the machine state, useful if the machine is in an error state

Inputs: no named parameters.

save_profileA

Save a new espresso extraction profile to the Meticulous machine. Use get_profile_schema first to understand the required format. The profile will be available immediately on the machine.

Inputs: profile (required).

search_shot_historyA

Search and list espresso shots with optional filters. Returns lightweight results by default. Use get_shot_details to get full timeseries data for a specific shot.

Inputs: query, start_date, end_date, max_results.

start_brewA

Start brewing espresso using the currently loaded profile. Make sure the machine is ready and a profile is loaded before calling this.

Inputs: no named parameters.

stop_brewA

Stop the current brewing operation immediately. Use this if something goes wrong or to manually end the extraction.

Inputs: no named parameters.

tare_scaleA

Zero/tare the built-in scale. Call this after placing your cup on the drip tray before starting a brew.

Inputs: no named parameters.

update_settingB

Update a specific machine setting. Use get_settings first to see available settings and their current values.

Inputs: setting_name (required), value (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.8/5.0

    Scored across 22 tools

    Disambiguation5/5

    Tools are clearly grouped by functionality (machine info, brewing, profiles, shot history, ratings, settings) with no overlap. Descriptions explicitly differentiate similar tools like get_current_shot, get_last_shot, and get_shot_details.

    Naming Consistency5/5

    All tool names consistently use verb_noun pattern in snake_case (e.g., get_device_info, start_brew, save_profile). No mixed conventions or inconsistent verb tense.

    Tool Count4/5

    22 tools is slightly above the typical 15 but still well-scoped for an espresso machine control surface covering device info, profile management, brewing, shot history, and settings. Each tool serves a distinct purpose.

    Completeness4/5

    Covers major operations: profile CRUD (except delete), brewing lifecycle, shot history with details, and settings. Minor gap: no explicit delete profile tool, but core workflows are supported.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers