TimeZest MCP server

TimeZest MCP Server

MCP (Model Context Protocol) server for TimeZest scheduling platform. Enables LLM agents to create and manage technician scheduling requests with PSA integration.

Features

• 🎯 Flat tool list - every tool listed and callable immediately
• 📅 Full scheduling lifecycle - create, view, cancel requests
• 🔗 PSA integration - ConnectWise, Autotask, Halo support
• 🌍 IANA timezone handling - explicit timezone management
• 🚀 Dual trigger modes - PSA workflows or booking URLs
• 🛡️ Gateway-ready - stateless per-request design
• 🔍 TQL filtering - TimeZest Query Language support
• ✨ Elicitation support - interactive user prompts
• 📇 Interactive scheduling-request card (MCP Apps) - timezestschedulingget renders as a card in MCP Apps hosts; neutral by default, brandable via window.BRAND injection or MCPBRAND env vars

Quick Start

Docker (Recommended)

docker run -it --rm \
  -e TIMEZEST_API_TOKEN=your-api-token \
  ghcr.io/wyre-ai/timezest-mcp:latest

npm

npm install -g @wyre-ai/timezest-mcp
TIMEZEST_API_TOKEN=your-token timezest-mcp

Configuration

Tools

Every tool below is listed and callable immediately — there is no domain to enter first. The groupings are documentation only.

Upgrading from 2.x? timezestnavigate and timezestback are gone.

Nothing replaces them: call the domain tools directly, because they are all

listed up front now. A client that used to call

timezestnavigate({domain: "agents"}) and then timezestagents_list

should just call timezestagentslist — likewise

timezestschedulinglist and the rest. timezest_status still works and

now reports the available tools instead of a menu to enter.

Status

• timezest_status - Show connection status and the available tools

Agents

• timezestagentslist - List individual technicians
• timezestagentsget - Get agent details

Teams

• timezestteamslist - List teams (round-robin scheduling)
• timezestteamsget - Get team details

Appointment Types

• timezestappointmenttypes_list - List available service types
• timezestappointmenttypes_get - Get appointment type details

Resources

• timezestresourceslist - List all resources (agents + teams)

Scheduling (Core Domain)

• timezestschedulinglist - List scheduling requests
• timezestschedulingget - Get request details
• timezestschedulingcreaterequest - Create new request** (key tool)
• timezestschedulingcancel - Cancel request

Usage Examples

Check What's Available

User: "What can TimeZest do?"
Tools: timezest_status

Create a Scheduling Request

User: "Book a technician for server repair at Customer Corp tomorrow"
Tools: timezest_scheduling_create_request({
  "appointmentTypeId": "repair-onsite",
  "triggerMode": "pod",
  "endUser": {
    "name": "John Doe",
    "company": "Customer Corp",
    "email": "john@customer.com"
  },
  "timeRange": {
    "earliestDate": "2024-02-01",
    "earliestTime": "09:00",
    "latestDate": "2024-02-01", 
    "latestTime": "17:00",
    "timezone": "America/New_York"
  },
  "associatedEntities": [
    {"type": "connectwise", "id": "12345", "number": "T20240001"}
  ]
})

PSA Integration

Shortened. The full README is on GitHub.