This Tekmetric MCP server provides a Claude-accessible interface to your Tekmetric shop data. It lets you ask natural-language questions about customers, vehicles, repair orders, appointments, inventory, and more, and receive structured results and AI-powered insights. The server uses Tekmetric's API directly and is read-only, designed to help you retrieve information and analytics without manual data exports. You can perform queries like finding a customer by name, listing upcoming appointments, analyzing a vehicle's service history, or inspecting repair orders by status. The tool suite emphasizes contextual outputs (e.g., formatted tables and timelines) to help you take action quickly within Claude.

To use it, start the MCP server with the provided binary (tekmetric-mcp) in serve mode and configure your API credentials in the environment. Once running, connect Claude Desktop to the server by adding it to your Claude configuration and providing your Tekmetric API credentials. After connection, you can ask questions in natural language and receive direct, real-time data from your Tekmetric shop.

Prerequisites:

• Go 1.23+ installed on your machine
• Claude Desktop installed and configured
• Tekmetric API credentials (Client ID and Client Secret) with access approved for API use

Step-by-step installation:

1. Clone the repository: git clone https://github.com/beetlebugorg/tekmetric-mcp.git cd tekmetric-mcp

2. Build the MCP server binary: make build

   or, if not using the Makefile, go build -o tekmetric-mcp ./...

3. Prepare environment variables (example): TEKMETRIC_CLIENT_ID=your_client_id TEKMETRIC_CLIENT_SECRET=your_client_secret TEKMETRIC_BASE_URL=https://shop.tekmetric.com TEKMETRIC_DEFAULT_SHOP_ID=123 TEKMETRIC_DEBUG=false

4. Run the server (in serve mode): ./tekmetric-mcp serve

5. Configure Claude Desktop to connect to the MCP server (manual installation reference in README):

   • Add an entry in ~/Library/Application Support/Claude/claude_desktop_config.json under mcpServers with the command path, arguments, and environment variables as shown in the example configuration.

6. Restart Claude Desktop and verify the connection using the CLI or Claude UI.

Tips and caveats:

• This MCP server is read-only with respect to Tekmetric data; it does not modify data in Tekmetric.
• Ensure your API credentials have the necessary scopes and that the base URL points to the correct environment (sandbox vs production).
• If you encounter authentication or rate-limiting issues, double-check the Client ID/Secret, the base URL, and consider enabling TEKMETRIC_DEBUG for verbose logs.
• The README notes that results may be limited to certain records per query to keep responses fast; plan queries accordingly for bulk data needs.
• For troubleshooting, verify the absolute path to the binary, executable permissions, and consult Claude Desktop Developer Tools for error details.