meticulous-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@meticulous-mcp show me the current machine status"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 |
|
| 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 settingsupdate_setting- Update a machine settingexecute_action- Execute machine actions
Profiles
list_profiles- List all profilesget_profile- Get profile detailsload_profile- Load a profile for brewingget_last_profile- Get the last used profilesave_profile- Create or update a profileget_profile_schema- Get the JSON schema for profiles
Brewing
start_brew- Start brewing with current profilestop_brew- Stop the current brewtare_scale- Tare the scalepreheat- Start preheatingreset_machine- Reset the machine
History
search_shot_history- Search shot historyget_shot_details- Get details of a specific shotget_last_shot- Get the most recent shotget_current_shot- Get current shot in progressget_history_stats- Get brewing statisticsrate_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"Related Projects
meticulous-bridge - Bridge agent for cloud connectivity
License
MIT
Available Tools
22 toolsexecute_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
Scored across 22 tools
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.
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.
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.
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
Related MCP Connectors
MCP server for progressive tool usage at any scale (see https://klavis.ai)
MCP server unifying ERPs, CRMs, APIs and knowledge base for Claude, ChatGPT and Gemini.
An MCP server that provides an API to LLMs to manage their JumpCloud resources.
Remote MCP server for supportsheep: run AI interviews and manage support content for your blog.
Related MCP Servers
- AlicenseAqualityDmaintenanceMCP server for "taming the Claude" with structured task queues.14134 npm71MIT
- AlicenseBqualityDmaintenanceMCP server for managing Claude Code conversation sessions1237 npmMIT

Robonine MCP Serverofficial
AlicenseAqualityDmaintenanceA local MCP server that connects Claude Code or any MCP-compatible AI assistant to a Robonine robot arm.1MIT- AlicenseAqualityDmaintenanceAn MCP server for Gaggiuino-modified espresso machines, enabling monitoring, shot analysis, and profile management.411 npm1MIT