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

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