Timergy

@timergy/mcp

Timergy の MCP サーバーです。スケジュール調整用の投票アプリです。Claude、ChatGPT、Gemini などの AI エージェントから、投票を作成し、時間枠に投票し、ミーティングを確定できます。

認証は不要です。 インストール後すぐに使えます。

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	はい	時間枠（タイムゾーン付き ISO 8601 形式の {start, end}）
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