Skip to main content
Glama
deenesjakoruzh
sagarkalra-tech

timezest-mcp

by sagarkalra-tech
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Remote

⏰ TimeZest MCP Server

npm version MCP Registry CI License: MIT

通过模型上下文协议（MCP）将您的 TimeZest 排程数据直接带入 Claude。 使用自然语言执行实时预约查询、工程师简报和与工单关联的排程管理。

注册表 ID： io.github.sagarkalra-tech/timezest-mcp

🌟 为什么选择 TimeZest MCP？

如果您管理一个使用 TimeZest 和 ConnectWise 的团队，您一定知道这些痛点：在标签页之间切换、手动查看谁已被预约、追踪未预约的排程请求，以及交叉核对工单号。

这个 MCP 服务器将 Claude 变成一个排程助手，它可以：

  • 🗓️ 按工程师分组，为您提供今日已确认预约的晨间简报

  • 🔍 按工单号查找预约 — 只需说“查找工单 #964400 的预约”

  • ⏳ 显示需要跟进的长期未预约请求

  • 📊 生成整个团队的汇总排程统计

  • 🕐 处理全球 MSP 团队的时区精确报告

Related MCP server: Autotask MCP Server

🚀 30 秒快速开始

前提条件

  • Node.js 20+ — 在此下载

  • TimeZest API 密钥 — 在 TimeZest → 设置 → API 中找到

选项 1：Claude Desktop（推荐）

将此添加到您的 Claude Desktop 配置文件中：

  • Windows： %APPDATA%\Claude\claude_desktop_config.json

  • macOS： ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "timezest": {
      "command": "npx",
      "args": ["-y", "timezest-mcp@latest"],
      "env": {
        "TIMEZEST_API_KEY": "your-timezest-api-key-here"
      }
    }
  }
}

重启 Claude Desktop。完成。

选项 2：Claude Code CLI

claude mcp add-json timezest-mcp '{
  "command": "npx",
  "args": ["-y", "timezest-mcp@latest"],
  "env": {
    "TIMEZEST_API_KEY": "your-timezest-api-key-here"
  }
}'

选项 3：VS Code（Copilot）

添加到您的 .vscode/settings.json 或用户设置中：

{
  "mcp": {
    "servers": {
      "timezest": {
        "command": "npx",
        "args": ["-y", "timezest-mcp@latest"],
        "env": {
          "TIMEZEST_API_KEY": "your-timezest-api-key-here"
        }
      }
    }
  }
}

🛠️ 可用工具

该服务器提供 8 个专用工具，Claude 可以调用：

工具

描述

关键参数

get_todays_appointments

晨间简报 — 按工程师分组的今日已确认预约，以及待处理的未预约请求

timezone

list_appointments

灵活查询任意日期范围，并支持可选筛选条件

start_date, end_date, engineer_name, status

get_engineer_schedule

特定工程师的所有即将到来的预约，按时间排序

engineer_name, days_ahead, include_pending

list_pending_requests

未预约的邀请（已发送/新），以小时/天跟踪时长

days_back, engineer_name, older_than_hours

find_appointment_by_ticket

查找与 ConnectWise 工单号关联的预约

ticket_number（例如 964400 或 #964400）

get_appointment_types

列出 TimeZest 中配置的所有预约类型定义

—

get_appointment_stats

汇总摘要：按状态、按工程师计数，今日负载，最旧的待处理项

days_back, days_forward

list_cancelled_appointments

已取消的请求，附有用于重新预约的排程 URL

days_back, engineer_name

💬 示例提示

连接后，只需自然地对 Claude 说话：

"Who are my top engineers today and what are they booked for?"

"Find any TimeZest requests for ticket #964400."

"Give me a morning briefing of today's confirmed vs. unbooked requests."

"Show me all pending scheduling requests older than 48 hours."

"What's the scheduling volume breakdown for the last two weeks?"

"Pull up Sarah's schedule for the next 5 days."

"List all cancelled appointments from last week — any we should rebook?"

⚙️ 配置

环境变量

必需

默认值

用途

TIMEZEST_API_KEY

是

—

您的 TimeZest Bearer 令牌（设置 → API）

TIMEZEST_DEFAULT_TZ

否

America/Chicago

用于本地化显示字符串的默认 IANA 时区

TIMEZEST_WINDOW_DAYS_BACK

否

14

向后获取排程请求的天数

TIMEZEST_WINDOW_DAYS_FORWARD

否

30

向前获取排程请求的天数

🏗️ 架构

┌─────────────────────────────────────────────────────────────────┐
│                        MCP CLIENT (Claude)                      │
│        Desktop App  •  Claude Code CLI  •  IDE Plugin           │
└──────────────────────────┬──────────────────────────────────────┘
                           │ Stdio (JSON-RPC)
┌──────────────────────────▼──────────────────────────────────────┐
│                     TIMEZEST MCP SERVER                         │
│                                                                 │
│  ┌──────────────┐  ┌──────────────┐                             │
│  │ Tool Handler │  │  MCP SDK     │  (index.ts)                 │
│  │ (8 Tools)    │  │  Registry    │                             │
│  └──────┬───────┘  └──────────────┘                             │
│         │                                                       │
│  ┌──────▼────────────────────────────────────────────────────┐  │
│  │                 TIMEZEST API CLIENT                        │  │
│  │  Pagination • Retry Logic • Rate Limit Management         │  │
│  └──────────────────────┬────────────────────────────────────┘  │
│                         │ (client.ts)                            │
│  ┌──────────────────────▼────────────────────────────────────┐  │
│  │               DATA TRANSFORMATION LAYER                    │  │
│  │  Timezone Math • Engineer Mapping • Ticket Linking         │  │
│  └────────────────────────────────────────────────────────────┘  │
│                         │ (utils/)                               │
└─────────────────────────┼────────────────────────────────────────┘
                          │ HTTPS / REST
┌─────────────────────────▼──────────────────────────────────────┐
│                      TIMEZEST API (v1)                          │
│       Scheduling Requests • Appointment Types • Resources       │
└─────────────────────────────────────────────────────────────────┘

关键设计决策

  • 只读：有意保持只读 — 不会对您的排程数据进行任何修改

  • 弹性客户端：指数退避，自动支持 429/5xx 错误的 Retry-After 头

  • 深度分页：递归爬取所有页面（每 50 项）以构建完整数据集

  • 时区精度：使用 IANA 时区标识符将 Unix 时间戳转换为严格的 ISO 格式，并附带本地化显示字符串

  • 工程师解析：使用“最高置信度”搜索 — 首先检查 scheduled_agents，然后回退到 resources

  • 热缓存：首次获取后缓存预约类型，以减少 API 开销

🧪 测试

该服务器附带一套全面的 Vitest 测试套件 — 3 个文件中的 22 个测试：

测试文件

测试数

覆盖范围

transform.test.ts

8

工程师解析、工单提取、时区转换、缺失字段的优雅处理

filter.test.ts

6

不区分大小写的部分匹配、团队名称匹配、日期范围筛选

client.test.ts

8

预约类型缓存、分页、429/5xx 重试、4xx 不重试

所有测试均使用模拟 API 响应 — 无需实时 API 调用，无需密钥。

npm test            # Single run
npm run test:watch  # Re-runs on file save

🔒 安全与信任

  • NPM 来源验证：每个版本都通过 GitHub Actions OIDC 进行加密签名

  • CI/CD 流水线：在标记版本上自动构建 → 测试 → 发布（无需手动 npm publish）

  • CI 中无密钥：测试不需要 API 密钥 — 使用模拟响应完全确定性

  • Node.js 矩阵：在 Node 20（LTS）和 22（当前）上测试

📦 分发

渠道

链接

NPM

timezest-mcp

MCP Registry

io.github.sagarkalra-tech/timezest-mcp

GitHub

sagarkalra-tech/TimeZest-MCP

🤝 贡献

  1. 复刻（Fork）该仓库

  2. 创建功能分支（git checkout -b feat/my-feature）

  3. 进行更改并确保测试通过（npm test）

  4. 提交拉取请求

请参阅 ARCHITECTURE.md 深入了解数据流、组件设计和转换逻辑。

📄 许可证

MIT © 2026 Sagar Kalra

This server cannot be installed

RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd
A
license - permissive license
Not graded
quality - not tested
C
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
0dRelease cycle
4Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

View all related MCP servers

Related MCP Connectors

  • Astravue MCP

    Manage projects, tasks, time tracking, and team collaboration through natural language.

  • timezone-toolkit

    Timezone tools for agents: convert, world clock, offset, lookup, date math, holidays, slots. x402

  • kesslerio-attio-mcp-server-beta

    Streamline your Attio workflows using natural language to search, create, update, and organize com…

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/sagarkalra-tech/TimeZest-MCP'

If you have feedback or need assistance with the MCP directory API, please join our Discord server