Connecting Claude (MCP)

The GarageAgent MCP server connects your garage to any assistant that supports the Model Context Protocol — including Claude Desktop. Once connected, you can just ask your assistant about your garage.

Prerequisites

  • A Pro or Growth plan.
  • An API key from Dashboard → Developers.
  • Node.js 20+ installed.
  • Claude Desktop (or another MCP client).

Configure Claude Desktop

Open Claude Desktop's configuration file:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Add a garageagent entry under mcpServers, pasting your API key:

{
  "mcpServers": {
    "garageagent": {
      "command": "npx",
      "args": ["-y", "@garageagent/mcp"],
      "env": {
        "GARAGEAGENT_API_KEY": "ga_live_your_key_here"
      }
    }
  }
}

Save the file and restart Claude Desktop. You should see GarageAgent's tools become available.

Try it

Ask your assistant things like:

What's on my schedule today?
Am I free Thursday afternoon for a 1-hour service?
Show me any cancelled bookings this month.
What services do I offer and for how much?

The assistant chains the tools automatically — for example, to answer "can I fit an MOT in on Thursday?" it looks up the MOT's duration, checks availability, and reads that day's existing bookings, then replies in plain language.

What it can access

The MCP server is read-only. It can view your schedule, bookings, availability, and services — it cannot create, change, or cancel anything. It authenticates with your API key and talks to GarageAgent over HTTPS; it never has direct access to the database.

Available tools

| Tool | What it does | |------|--------------| | get_todays_schedule | Today's bookings, in your timezone | | list_bookings | Bookings filtered by date range and status | | check_availability | Open slots for a date, sized to a service | | list_services | Your services, durations, and prices | | get_booking | Full detail of one booking by reference |

Troubleshooting

  • Tools don't appear — check the config JSON is valid and restart Claude Desktop fully.
  • "Invalid or revoked API key" — generate a fresh key in Developers and update the config.
  • "API key required" — make sure GARAGEAGENT_API_KEY is set in the env block.