Timergy

@timergy/mcp

适用于 Timergy 的 MCP 服务——一款日程投票应用。直接通过 Claude、ChatGPT 和 Gemini 等 AI Agent 创建投票、为时间段投票并确定会议时间。

**无需身份验证。**开箱即用。

什么是 Timergy？

Timergy 是一项日程投票服务（类似 Doodle 或 When2Meet）。创建包含多个时间段选项的投票，将其分享给参与者，所有人投票选择方便的时间，然后选出最佳时间。

快速开始

Claude Desktop / Claude Code

将以下内容添加到 MCP 配置文件（~/.claude/claude_desktop_config.json 或项目的 .mcp.json）中：

{
  "mcpServers": {
    "timergy": {
      "command": "npx",
      "args": ["@timergy/mcp"]
    }
  }
}

然后只需提出请求：

“为下周五或周六晚上安排晚餐投票”

Smithery（远程，无需安装）

smithery mcp add timergy/timergy

也可以通过 https://timergy--timergy.run.tools 直接连接

其他 MCP 客户端

任何兼容 MCP 的客户端都可以使用此服务。支持 stdio（本地）和 Streamable HTTP（远程，地址为 https://api.timergy.com/mcp）。

工具

create_poll

创建包含多个时间段选项的日程投票。

参数	类型	必填	描述
title	string	是	投票标题
options	array	是	时间段（{start, end}，使用带时区的 ISO 8601 格式）
description	string	否	投票说明
deadline	string	否	投票截止时间（ISO 8601）
location	string	否	活动地点
creatorName	string	否	显示为投票创建者的姓名

"Create a poll called 'Team Lunch' with slots on Monday 12-13 and Tuesday 12-13"

返回：投票 URL（用于分享）、口令（用于管理员访问）、选项 ID。

get_poll

获取投票详情和时间段选项（不含投票结果）。投票或确定最终时间前，可用此工具获取选项 ID。

参数	类型	必填	描述
pollId	string	是	投票 UUID

"Show me the details of poll abc-123"

vote_on_poll

提交投票。每张选票将一个时间段映射为 yes/maybe/no。

参数	类型	必填	描述
pollId	string	是	投票 UUID
voterName	string	是	投票者姓名
voterEmail	string	否	投票者邮箱（用于通知）
votes	array	是	{optionId, availability}，其中 availability 为 yes/maybe/no

"Vote 'yes' for Monday and 'no' for Tuesday on poll abc-123 as Max"

get_results

查看投票者以及最受欢迎的时间段。

参数	类型	必填	描述
pollId	string	是	投票 UUID

"Show me the results for poll abc-123"

finalize_poll

确定最终时间段并锁定。向提供了邮箱的参与者发送通知。

参数	类型	必填	描述
pollId	string	是	投票 UUID
optionId	string	是	获胜时间段的 UUID
passphrase	string	否	管理员口令（从 create_poll 自动记住）

"Finalize poll abc-123 with the Monday slot"

工作流

1. create_poll  ->  Get poll URL + passphrase
2. Share URL    ->  Send to participants
3. get_results  ->  See who voted yes/maybe/no
4. finalize_poll -> Pick the best time, lock it in

在同一会话中，步骤 1 的口令会自动记住，并用于步骤 4。

REST API

MCP 服务在底层调用 Timergy Open API。你也可以直接使用该 API：

方法	端点	描述
POST	/api/open/polls	创建投票
GET	/api/open/polls/:id	获取投票详情
GET	/api/open/polls/:id/options	获取时间段
GET	/api/open/polls/:id/results	获取投票结果
POST	/api/open/polls/:id/vote	提交投票
POST	/api/open/polls/:id/admin-token	获取管理员令牌
POST	/api/open/polls/:id/finalize	确定最终投票结果

基础 URL：https://api.timergy.com

OpenAPI 规范：https://api.timergy.com/api/open/openapi.json

配置

环境变量	默认值	描述
TIMERGY_API_URL	https://api.timergy.com	API 基础 URL

本地开发：

{
  "mcpServers": {
    "timergy": {
      "command": "npx",
      "args": ["@timergy/mcp"],
      "env": { "TIMERGY_API_URL": "http://localhost:4000" }
    }
  }
}

Rate Limits

Action	Limit
Create poll	5 per hour
Vote	20 per minute
Get poll/results	60 per minute
Admin token	5 per 10 minutes
Finalize	3 per hour

License

MIT