Server data from the Official MCP Registry
Create scheduling polls, vote, and finalize times from AI agents.
About
Create scheduling polls, vote, and finalize times from AI agents.
Security Report
Valid MCP server (2 strong, 4 medium validity signals). No known CVEs in dependencies. Package registry verified. Imported from the Official MCP Registry.
5 files analyzed · 1 issue found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
Permissions Required
This plugin requests these system permissions. Most are normal for its category.
How to Install
Add this to your MCP configuration file:
{
"mcpServers": {
"io-github-dockerdiscordcontrol-timergy": {
"args": [
"-y",
"@timergy/mcp"
],
"command": "npx"
}
}
}Documentation
View on GitHubFrom the project's GitHub 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
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 |
"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_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 |
"Show me the details of poll abc-123"
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 |
"Vote 'yes' for Monday and 'no' for Tuesday on poll abc-123 as Max"
get_results
See who voted and which time slots are most popular.
| Parameter | Type | Required | Description |
|---|---|---|---|
pollId | string | yes | Poll UUID |
"Show me the results for poll abc-123"
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) |
"Finalize poll abc-123 with the Monday slot"
Workflow
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
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:
| Method | Endpoint | Description |
|---|---|---|
POST | /api/open/polls | Create a poll |
GET | /api/open/polls/:id | Get poll details |
GET | /api/open/polls/:id/options | Get time slots |
GET | /api/open/polls/:id/results | Get vote results |
POST | /api/open/polls/:id/vote | Submit votes |
POST | /api/open/polls/:id/admin-token | Get admin token |
POST | /api/open/polls/:id/finalize | Finalize poll |
Base URL: https://api.timergy.com
OpenAPI spec: https://api.timergy.com/api/open/openapi.json
Configuration
| Environment Variable | Default | Description |
|---|---|---|
TIMERGY_API_URL | https://api.timergy.com | API base URL |
For local development:
{
"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
Reviews
No reviews yet
Be the first to review this server!
More Communication MCP Servers
Toleno
Freeby Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
mcp-creator-python
Freeby mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.
MarkItDown
Freeby Microsoft · Content & Media
Convert files (PDF, Word, Excel, images, audio) to Markdown for LLM consumption
MCP Marketplace
Freeby mcp-marketplace · Developer Tools
Search and install MCP servers from inside your AI client.
FinAgent
Freeby mcp-marketplace · Finance
Free stock data and market news for any MCP-compatible AI assistant.
mcp-creator-typescript
Freeby mcp-marketplace · Developer Tools
Scaffold, build, and publish TypeScript MCP servers to npm — conversationally