Timergy

timergy-app/timergy

Connects Claude to Timergy's scheduling poll API so you can coordinate meeting times without leaving the chat. You get five tools: create polls with time slot options, vote yes/maybe/no on behalf of participants, pull results to see who's available when, finalize the winning slot, and retrieve poll details. No auth needed, works immediately with npx. Useful when you're planning group events through conversation and want to generate shareable poll links, collect availability, and lock in times without switching to a browser. The server remembers admin passphrases within a session so you can create and finalize polls without manual credential juggling. Runs locally via stdio or remotely through their hosted endpoint.

tools: 5
transport: STDIO
last updated: Mar 16, 2026

View on GitHub

Tools

5 tools

Public tool metadata for what this MCP can expose to an agent.

create_pollCreate 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 s...6 params

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 s...

Parameters* required

creatorNamestring

Name shown as poll creator

deadlinestring

Optional voting deadline (ISO 8601)

descriptionstring

Optional poll description

locationstring

Optional event location

optionsarray

Time slot options (recommend 3-5)

titlestring

Poll title (e.g. 'Dinner with Moritz')

get_pollGet 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.1 params

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.

Parameters* required

pollIdstring

Poll UUID

vote_on_pollSubmit 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 wit...4 params

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 wit...

Parameters* required

pollIdstring

Poll UUID

voterEmailstring

Optional voter email

voterNamestring

Name of the voter

votesarray

One vote per time slot

get_resultsGet 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.1 params

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.

Parameters* required

pollIdstring

Poll UUID

finalize_pollFinalize 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 participa...3 params

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 participa...

Parameters* required

optionIdstring

Winning time slot option UUID

passphrasestring

Admin passphrase

pollIdstring

Poll UUID

Readme

@timergy/mcp

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):

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

Then just ask:

"Create a poll for dinner next Friday or Saturday evening"

Smithery (Remote, no install)

smithery mcp add timergy/timergy

Or connect directly via https://timergy--timergy.run.tools

Other MCP Clients

View the full README on GitHub

Details

Repository: github.com/timergy-app/timergy
Package: @timergy/mcp
Transport: STDIO
Registry: MCP registry, active