MCP server for Timergy - the scheduling poll app. Create polls, vote on time slots, and finalize meetings directly from AI agents like Claude, ChatGPT, and Gemini.
No authentication required. Works out of the box.
Timergy is a scheduling poll service (like Doodle or When2Meet). You create a poll with time slot options, share it with participants, everyone votes on their availability, and you pick the best time.
Related MCP server: Meeting Scheduler
Add to your MCP config (~/.claude/claude_desktop_config.json or project .mcp.json):
{
"mcpServers": {
"timergy": {
"command": "npx",
"args": ["@timergy/mcp"]
}
}
}Then just ask:
"Create a poll for dinner next Friday or Saturday evening"
smithery mcp add timergy/timergyOr connect directly via https://timergy--timergy.run.tools
Any MCP-compatible client can use this server. Supports stdio (local) and Streamable HTTP (remote at https://api.timergy.com/mcp).
create_pollCreate a scheduling poll with time slot options.
Parameter | Type | Required | Description |
| string | yes | Poll title |
| array | yes | Time slots ( |
| string | no | Poll description |
| string | no | Voting deadline (ISO 8601) |
| string | no | Event location |
| string | no | Name shown as poll creator |
"Create a poll called 'Team Lunch' with slots on Monday 12-13 and Tuesday 12-13"Returns: poll URL (to share), passphrase (for admin access), option IDs.
get_pollGet poll details and time slot options (no votes). Use this to retrieve option IDs before voting or finalizing.
Parameter | Type | Required | Description |
| string | yes | Poll UUID |
"Show me the details of poll abc-123"vote_on_pollSubmit votes on a poll. Each vote maps a time slot to yes/maybe/no.
Parameter | Type | Required | Description |
| string | yes | Poll UUID |
| string | yes | Name of the voter |
| string | no | Voter email (for notifications) |
| array | yes |
|
"Vote 'yes' for Monday and 'no' for Tuesday on poll abc-123 as Max"get_resultsSee who voted and which time slots are most popular.
Parameter | Type | Required | Description |
| string | yes | Poll UUID |
"Show me the results for poll abc-123"finalize_pollLock in the winning time slot. Notifies participants who provided an email.
Parameter | Type | Required | Description |
| string | yes | Poll UUID |
| string | yes | Winning time slot UUID |
| string | no | Admin passphrase (auto-remembered from 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 inThe passphrase from step 1 is automatically remembered for step 4 within the same session.
The MCP server calls the Timergy Open API under the hood. You can also use the API directly:
Method | Endpoint | Description |
|
| Create a poll |
|
| Get poll details |
|
| Get time slots |
|
| Get vote results |
|
| Submit votes |
|
| Get admin token |
|
| Finalize poll |
Base URL: https://api.timergy.com
OpenAPI spec: https://api.timergy.com/api/open/openapi.json
Environment Variable | Default | Description |
|
| API base URL |
For local development:
{
"mcpServers": {
"timergy": {
"command": "npx",
"args": ["@timergy/mcp"],
"env": { "TIMERGY_API_URL": "http://localhost:4000" }
}
}
}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 |
MIT
Create a Timergy scheduling poll (like Doodle) where participants vote on preferred time slots. Provide a title and at least 2-5 time slot options with ISO 8601 date-times (include timezone, e.g. 2026-03-20T18:00:00+02:00 or use UTC with Z suffix). Returns a shareable URL to send to participants and a passphrase for admin access. The passphrase is automatically remembered for finalize_poll. Workflow: create_poll -> share URL -> wait for votes -> get_results -> finalize_poll.
Inputs: title (required), options (required), description, deadline, +2 more.
Finalize a poll by picking the winning time slot. Call get_results first to find the best optionId. Uses the passphrase auto-saved from create_poll. If the MCP server was restarted since poll creation, provide the passphrase manually. This locks the poll and notifies participants who provided an email.
Inputs: pollId (required), optionId (required), passphrase.
Get poll metadata and time slot options (but NOT votes). Returns title, status, deadline, location, and all available time slots with their option IDs. Use this to retrieve optionId values needed for vote_on_poll or finalize_poll. To see who voted, use get_results instead.
Inputs: pollId (required).
Get voting results for a Timergy poll, showing who voted yes/maybe/no for each time slot. Use this after participants have voted to see which slot has the most availability. To finalize, pick the optionId with the most 'yes' votes and call finalize_poll.
Inputs: pollId (required).
Submit votes on a Timergy poll. First call get_poll to retrieve the available optionId values. Each vote maps an optionId to an availability: 'yes' (available), 'maybe' (might work), or 'no' (unavailable). A unique voter token is auto-generated per voter name. Resubmitting with the same voter name updates previous votes.
Inputs: pollId (required), voterName (required), votes (required), voterEmail.
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 5 tools
Each tool has a distinct purpose: creating polls, getting info, voting, viewing results, finalizing. No overlap.
All tools follow a consistent verb_noun_snake_case pattern, e.g., create_poll, get_results.
Five tools cover the essential poll lifecycle without being too many or too few.
Covers the main workflow from creation to finalization. Missing update/delete operations, but not critical for scheduling polls.
Agent-first meeting schedule polls for humans and agents. Create polls, vote, find times.
Create and query group meeting availability polls, time-zone slots, and scheduling links.
Find a date that works for a group: answer a poll from its link, or create one and invite guests.
Find a time a group can meet: no-login availability poll that picks the best meeting slot.
