Tekmetric API and MCP server Let your AI agent work your Tekmetric Job Board.

ToolWhat it doesAccess

• list_job_board Lists repair orders on the Job Board, by column. read

  Returns one row per repair order with its column, card status, customer, vehicle, job count and total. Each row says whether the estimate was sent or viewed, the same paper airplane and eye icons the Job Board shows. Declined and deleted repair orders are not in the default view.

  MCP calltekmetric_read → list_job_board

  REST endpointGET https://cotlet.dev/api/v1/tekmetric/job-boards

  Parameters

  Parameters: list_job_board

  Name	Type	Description
  column string	string	estimates, work_in_progress or completed. Defaults to all three.
  status string	string	Card status, for example Not Started, Requires Authorization, Pending Authorization or Declined All.
  employee string	string	Name of an employee, to see only their repair orders.
  cursor string	string	Next page cursor from the previous call.

  Example response

  {
    "repair_orders": [
      {
        "repair_order_id": "ro_30412",
        "column": "estimates",
        "status": "Pending Authorization",
        "customer": "Dana Whitfield",
        "vehicle": "2017 Honda CR-V",
        "jobs": 3,
        "total": "$842.10",
        "estimate_sent": true,
        "estimate_viewed": false
      },
      {
        "repair_order_id": "ro_30415",
        "column": "work_in_progress",
        "status": "In progress",
        "customer": "Luis Ortega",
        "vehicle": "2014 Ford F-150",
        "jobs": 5,
        "total": "$1,620.40",
        "estimate_sent": true,
        "estimate_viewed": true
      },
      {
        "repair_order_id": "ro_30409",
        "column": "completed",
        "status": "Completed",
        "customer": "Priya Nair",
        "vehicle": "2020 Toyota Camry",
        "jobs": 2,
        "total": "$376.00",
        "estimate_sent": true,
        "estimate_viewed": true
      }
    ],
    "next_cursor": null
  }

• get_repair_order Reads one repair order with its jobs, parts and authorization state. read

  Returns the customer, vehicle, each job with its status and price, the total and how each job was authorized (digital signature, phone call, text message and so on). Inspections and photos are not returned.

  MCP calltekmetric_read → get_repair_order

  REST endpointGET https://cotlet.dev/api/v1/tekmetric/repair-orders/{repair_order_id}

  Parameters

  Parameters: get_repair_order

  Name	Type	Description
  repair_order_id string required	string	Repair order ID from list_job_board.

  Example input

  {
    "repair_order_id": "repair_order_8c41d2"
  }

  Example response

  {
    "repair_order_id": "ro_30412",
    "customer": "Dana Whitfield",
    "vehicle": "2017 Honda CR-V",
    "column": "estimates",
    "jobs": [
      {
        "name": "Front brake pads and rotors",
        "price": "$512.30",
        "authorized": false
      },
      {
        "name": "Cabin air filter",
        "price": "$64.80",
        "authorized": false
      },
      {
        "name": "Oil and filter change",
        "price": "$265.00",
        "authorized": false
      }
    ],
    "total": "$842.10"
  }

• share_estimate Sends the estimate of a repair order to the customer, like Share Estimate in the app. writeasks first

  The customer receives a link to the estimate and can authorize jobs from it. The repair order shows the paper airplane icon after sending. The estimate must be ready to share. By default you confirm each call; you can switch that off for this tool.

  MCP calltekmetric_write → share_estimate

  REST endpointPOST https://cotlet.dev/api/v1/tekmetric/repair-orders/{repair_order_id}/estimate/share

  Parameters

  Parameters: share_estimate

  Name	Type	Description
  repair_order_id string required	string	Repair order ID from list_job_board.
  channel string	string	text or email. Defaults to text.

  Example input

  {
    "repair_order_id": "repair_order_8c41d2"
  }

  Example response

  {
    "repair_order_id": "ro_30412",
    "channel": "text",
    "sent_to": "+1 555 0142",
    "status": "sent",
    "sent_at": "2026-10-28T09:12:00Z"
  }

ToolWhat it doesAccess

• list_customers Finds customers by name, phone number or email. read

  Returns matching customers newest first with their phone numbers and vehicle count. Use customer_id with get_customer for the full record.

  MCP calltekmetric_read → list_customers

  REST endpointGET https://cotlet.dev/api/v1/tekmetric/customers

  Parameters

  Parameters: list_customers

  Name	Type	Description
  query string required	string	Name, phone number or email.
  cursor string	string	Next page cursor from the previous call.

  Example input

  {
    "query": "query"
  }

  Example response

  {
    "customers": [
      {
        "customer_id": "cu_8841",
        "name": "Dana Whitfield",
        "phone": "+1 555 0142",
        "vehicles": 2
      },
      {
        "customer_id": "cu_8853",
        "name": "Dana Whitaker",
        "phone": "+1 555 0177",
        "vehicles": 1
      }
    ],
    "next_cursor": null
  }

• get_customer Reads a customer with their phone numbers, vehicles and repair orders. read

  Returns the contact details on the customer profile, each vehicle with its ID, and recent repair orders. The agent uses the vehicle ID to book an appointment.

  MCP calltekmetric_read → get_customer

  REST endpointGET https://cotlet.dev/api/v1/tekmetric/customers/{customer_id}

  Parameters

  Parameters: get_customer

  Name	Type	Description
  customer_id string required	string	Customer ID from list_customers.

  Example input

  {
    "customer_id": "customer_8c41d2"
  }

  Example response

  {
    "customer_id": "cu_8841",
    "name": "Dana Whitfield",
    "phones": [
      "+1 555 0142"
    ],
    "vehicles": [
      {
        "vehicle_id": "ve_5520",
        "name": "2017 Honda CR-V"
      },
      {
        "vehicle_id": "ve_5521",
        "name": "2011 Mazda 3"
      }
    ],
    "repair_orders": [
      {
        "repair_order_id": "ro_30412",
        "column": "estimates"
      }
    ]
  }

• list_appointments Lists appointments on the shop calendar for a date range. read

  Returns appointments in time order with customer, vehicle and the appointment type, which shows who waits at the shop and who drops off the vehicle and returns later.

  MCP calltekmetric_read → list_appointments

  REST endpointGET https://cotlet.dev/api/v1/tekmetric/appointments

  Parameters

  Parameters: list_appointments

  Name	Type	Description
  from string required	string	First day, YYYY-MM-DD.
  to string	string	Last day, YYYY-MM-DD. Defaults to the same day.
  cursor string	string	Next page cursor from the previous call.

  Example input

  {
    "from": "from"
  }

  Example response

  {
    "appointments": [
      {
        "appointment_id": "ap_2201",
        "start": "2026-10-29T08:00:00",
        "customer": "Luis Ortega",
        "vehicle": "2014 Ford F-150",
        "type": "Drop off",
        "title": "Brake inspection"
      },
      {
        "appointment_id": "ap_2204",
        "start": "2026-10-29T09:00:00",
        "customer": "Dana Whitfield",
        "vehicle": "2017 Honda CR-V",
        "type": "Waiting",
        "title": "Oil change"
      }
    ],
    "next_cursor": null
  }

• create_appointment Books an appointment on the shop calendar for a customer and vehicle. writeasks first

  Adds the appointment to the calendar and blocks that time. The customer may be told about it, so the call waits for your OK. It does not check the bay calendar for you: call list_appointments first. By default you confirm each call; you can switch that off for this tool.

  MCP calltekmetric_write → create_appointment

  REST endpointPOST https://cotlet.dev/api/v1/tekmetric/customers/{customer_id}/appointments

  Parameters

  Parameters: create_appointment

  Name	Type	Description
  customer_id string required	string	Customer ID from list_customers.
  vehicle_id string required	string	Vehicle ID from get_customer.
  start string required	string	Start time, ISO 8601, in the shop time zone.
  title string required	string	What the visit is for, for example Oil change.
  type string	string	Waiting or Drop off.

  Example input

  {
    "customer_id": "customer_8c41d2",
    "vehicle_id": "vehicle_8c41d2",
    "start": "start",
    "title": "title"
  }

  Example response

  {
    "appointment_id": "ap_2209",
    "start": "2026-10-29T09:00:00",
    "customer": "Dana Whitfield",
    "vehicle": "2017 Honda CR-V",
    "title": "Oil change",
    "type": "Waiting",
    "status": "booked"
  }

ToolWhat it doesAccess

• list_message_threads Lists Tekmessage threads, newest first. read

  Needs Tekmessage turned on for the shop and the "Can message customers" permission for your employee. Returns the customer, the last message and whether it is unread. Reading does not mark a thread as read.

  MCP calltekmetric_read → list_message_threads

  REST endpointGET https://cotlet.dev/api/v1/tekmetric/message-threads

  Parameters

  Parameters: list_message_threads

  Name	Type	Description
  unread_only boolean	boolean	Only threads with unread messages.
  cursor string	string	Next page cursor from the previous call.

  Example response

  {
    "threads": [
      {
        "thread_id": "th_9017",
        "customer_id": "cu_8841",
        "customer": "Dana Whitfield",
        "last_message": "Can you do the brakes but skip the filter?",
        "unread": true
      },
      {
        "thread_id": "th_9011",
        "customer_id": "cu_8870",
        "customer": "Sam Reyes",
        "last_message": "What time do you close today?",
        "unread": true
      }
    ],
    "next_cursor": null
  }

• get_message_thread Reads the messages of one Tekmessage thread. read

  Returns messages in time order, each marked as from the customer or from the shop, with delivery state. Estimates and invoices shared from the repair order appear as links.

  MCP calltekmetric_read → get_message_thread

  REST endpointGET https://cotlet.dev/api/v1/tekmetric/threads/{thread_id}/message-thread

  Parameters

  Parameters: get_message_thread

  Name	Type	Description
  thread_id string required	string	Thread ID from list_message_threads.

  Example input

  {
    "thread_id": "thread_8c41d2"
  }

  Example response

  {
    "thread_id": "th_9017",
    "customer": "Dana Whitfield",
    "messages": [
      {
        "from": "shop",
        "text": "Your estimate is ready: https://example.tekmetric.test/e/abc123",
        "delivered": true
      },
      {
        "from": "customer",
        "text": "Can you do the brakes but skip the filter?",
        "delivered": true
      }
    ]
  }

• send_message Sends a text to a customer from the shop number through Tekmessage. writeasks first

  Sends from the shop number and the text reaches a real person. Tekmetric does not allow deleting a sent message. Needs Tekmessage on and the "Can message customers" permission. By default you confirm each call; you can switch that off for this tool.

  MCP calltekmetric_write → send_message

  REST endpointPOST https://cotlet.dev/api/v1/tekmetric/customers/{customer_id}/messages

  Parameters

  Parameters: send_message

  Name	Type	Description
  customer_id string required	string	Customer ID from list_customers.
  body string required	string	Message text.

  Example input

  {
    "customer_id": "cu_8841",
    "body": "Hi Dana, your CR-V is ready for pickup. We close at 6 pm. Thanks, Main Street Auto."
  }

  Example response

  {
    "message_id": "msg_55210",
    "customer": "Dana Whitfield",
    "thread_id": "th_9017",
    "status": "delivered",
    "sent_at": "2026-10-28T09:14:00Z"
  }