English Français العربية

Timergy

Registre officiel IA et agents

Create scheduling polls, vote, and finalize times from AI agents.

Code source Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

NPM package @timergy/mcp
Claude Code 
claude mcp add timergy -- npx -y @timergy/mcp@0.1.4
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "timergy": {
            "command": "npx",
            "args": [
                "-y",
                "@timergy/mcp@0.1.4"
            ]
        }
    }
}

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. @timergy/mcp
  2. What is Timergy?
  3. Quick Start
  4. Tools
  5. Workflow
  6. REST API
  7. Configuration
  8. Rate Limits
  9. License

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

ParameterTypeRequiredDescription
titlestringyesPoll title
optionsarrayyesTime slots ({start, end} in ISO 8601 with timezone)
descriptionstringnoPoll description
deadlinestringnoVoting deadline (ISO 8601)
locationstringnoEvent location
creatorNamestringnoName 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.

ParameterTypeRequiredDescription
pollIdstringyesPoll 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.

ParameterTypeRequiredDescription
pollIdstringyesPoll UUID
voterNamestringyesName of the voter
voterEmailstringnoVoter email (for notifications)
votesarrayyes{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.

ParameterTypeRequiredDescription
pollIdstringyesPoll UUID
"Show me the results for poll abc-123"
finalize_poll

Lock in the winning time slot. Notifies participants who provided an email.

ParameterTypeRequiredDescription
pollIdstringyesPoll UUID
optionIdstringyesWinning time slot UUID
passphrasestringnoAdmin 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:

MethodEndpointDescription
POST/api/open/pollsCreate a poll
GET/api/open/polls/:idGet poll details
GET/api/open/polls/:id/optionsGet time slots
GET/api/open/polls/:id/resultsGet vote results
POST/api/open/polls/:id/voteSubmit votes
POST/api/open/polls/:id/admin-tokenGet admin token
POST/api/open/polls/:id/finalizeFinalize poll

Base URL: https://api.timergy.com

OpenAPI spec: https://api.timergy.com/api/open/openapi.json

Configuration

Environment VariableDefaultDescription
TIMERGY_API_URLhttps://api.timergy.comAPI base URL

For local development:

{
  "mcpServers": {
    "timergy": {
      "command": "npx",
      "args": ["@timergy/mcp"],
      "env": { "TIMERGY_API_URL": "http://localhost:4000" }
    }
  }
}

Rate Limits

ActionLimit
Create poll5 per hour
Vote20 per minute
Get poll/results60 per minute
Admin token5 per 10 minutes
Finalize3 per hour

License

MIT

Questions fréquentes

Qu'est-ce que Timergy ?

Create scheduling polls, vote, and finalize times from AI agents.

Comment installer Timergy ?

Il s'exécute sur votre machine. Dans Claude Code : claude mcp add timergy -- npx -y @timergy/mcp@0.1.4. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour Timergy ?

Son entrée au registre n'indique aucune clé ni secret obligatoire. Certaines fonctions peuvent tout de même demander un compte auprès du service auquel il se connecte.

Timergy est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient Timergy ?

Il est publié par timergy-app. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.