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"]
    }
  }
}

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"

Related Projects

• meticulous-bridge - Bridge agent for cloud connectivity

License

MIT