timergy-app/timergy

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.
What is Timergy?
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.
Quick Start
Claude Desktop / Claude Code
Add to your MCP config (~/.claude/claude_desktop_config.json or project .mcp.json):
Then just ask:
> "Create a poll for dinner next Friday or Saturday evening"
Smithery (Remote, no install)
Or connect directly via https://timergy--timergy.run.tools
Other MCP Clients
Any MCP-compatible client can use this server. Supports stdio (local) and Streamable HTTP (remote at https://api.timergy.com/mcp).
Tools
create_poll
Create a scheduling poll with time slot options.
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| title | string | yes | Poll title |
| options | array | yes | Time slots ({start, end} in ISO 8601 with timezone) |
| description | string | no | Poll description |
| deadline | string | no | Voting deadline (ISO 8601) |
| location | string | no | Event location |
| creatorName | string | no | Name shown as poll creator |
Returns: poll URL (to share), passphrase (for admin access), option IDs.
get_poll
Get poll details and time slot options (no votes). Use this to retrieve option IDs before voting or finalizing.
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| pollId | string | yes | Poll UUID |
vote_on_poll
Submit votes on a poll. Each vote maps a time slot to yes/maybe/no.
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| pollId | string | yes | Poll UUID |
| voterName | string | yes | Name of the voter |
| voterEmail | string | no | Voter email (for notifications) |
| votes | array | yes | {optionId, availability} where availability is yes/maybe/no |
get_results
See who voted and which time slots are most popular.
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| pollId | string | yes | Poll UUID |
finalize_poll
Lock in the winning time slot. Notifies participants who provided an email.
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| pollId | string | yes | Poll UUID |
| optionId | string | yes | Winning time slot UUID |
| passphrase | string | no | Admin passphrase (auto-remembered from create_poll) |
Workflow
The passphrase from step 1 is automatically remembered for step 4 within the same session.
REST API
The MCP server calls the Timergy Open API under the hood. You can also use the API directly: