MCP server for time in cities around the world, time zones, DST, conversion, and meetings.
If you already use Findtime, the findtime mcp server is the piece that lets your assistant work with it directly. MCP server for time in cities around the world, time zones, DST, conversion, and meetings.
@findtime/mcp-server is a thin stdio MCP wrapper over the production findtime.io Time API at https://time-api.findtime.io.
The server ships on npm as @findtime/mcp-server, so your MCP client can launch it on demand — there is no separate build step. Add the server block to your client's configuration, restart it, and the tools register themselves.
The toolset is worth reading before you wire it up, because it tells you what the integration is really for:
GitHub — https://github.com/hkchao/findtime-mcp-serveranswer_time_question — get_findtime_helptime_snapshot — get_current_timeget_dst_schedule — convert_timeget_overlap_hours — find_meeting_timesearch_timezones — get_location_by_idFINDTIME_TIME_API_KEY — a valid findtime.io developer key from https://findtime.io/developers/keys/FINDTIME_TIME_API_BASE_URL — TIME_API_BASE_URLTIME_API_TIMEOUT_MS — FINDTIME_BINDING_TYPE for optional install/workspace binding context. Supported values: slack_team, workspace_id, install_idFINDTIME_MCP_CLIENT_TYPE — FINDTIME_MCP_TOOL_MODE=answer-only to expose only answer_time_question, get_findtime_help, and get_api_diagnostics for enterprise bots that shouldget_current_time — get_dst_scheduleconvert_time — get_overlap_hoursConfiguration is passed through the environment: FINDTIME_MCP_CLIENT_TYPE, FINDTIME_TIME_API_BASE_URL, FINDTIME_TIME_API_KEY, TIME_API_BASE_URL, FINDTIME_MCP_CLIENT_ID, FINDTIME_MCP_INSTALL_ID, FINDTIME_MCP_USAGE_TELEMETRY_URL, YOUR_FINDTIME_SECRET_KEY. Treat anything key-shaped as a real credential — scope it to the minimum the server needs, and rotate it if it ever lands in a shared config.
This sits in the developer tooling group, where several servers overlap in what they claim to do but differ sharply once you actually set them up. Findtime's toolset — GitHub, answer_time_question, time_snapshot and 11 more — is a fair guide to whether it matches your workflow. It is maintained by hkchao; worth a glance at recent repository activity before you build anything load-bearing on it.
This entry was verified against Findtime's own documentation before publication; SyncDev keeps the directory reviewed rather than auto-generated.
| Tool | What it does |
|---|---|
| GitHub | https://github.com/hkchao/findtime-mcp-server |
| answer_time_question | get_findtime_help |
| time_snapshot | get_current_time |
| get_dst_schedule | convert_time |
| get_overlap_hours | find_meeting_time |
| search_timezones | get_location_by_id |
| FINDTIME_TIME_API_KEY | a valid findtime.io developer key from https://findtime.io/developers/keys/ |
| FINDTIME_TIME_API_BASE_URL | TIME_API_BASE_URL |
| TIME_API_TIMEOUT_MS | FINDTIME_BINDING_TYPE for optional install/workspace binding context. Supported values: slack_team, workspace_id, install_id. |
| FINDTIME_MCP_CLIENT_TYPE | FINDTIME_MCP_TOOL_MODE=answer-only to expose only answer_time_question, get_findtime_help, and get_api_diagnostics for enterprise bots that should route every natural-language request through the answer API. |
| get_current_time | get_dst_schedule |
| convert_time | get_overlap_hours |
| find_meeting_time | get_location_by_id |
| Cursor | The Cursor tool exposed by this server. |
{
"preferences": {
"...": "keep your existing preferences here"
},
"mcpServers": {
"findtime": {
"command": "npx",
"args": ["-y", "@findtime/mcp-server"],
"env": {
"FINDTIME_TIME_API_BASE_URL": "https://time-api.findtime.io",
"FINDTIME_TIME_API_KEY": "YOUR_FINDTIME_SECRET_KEY"
}
}
}
}Configuration as documented by the project. Restart the client after saving.
| Variable | Description | Required |
|---|---|---|
| FINDTIME_MCP_CLIENT_TYPE | Configuration value read at startup. | Optional |
| FINDTIME_TIME_API_BASE_URL | Endpoint or connection string the server talks to. | Yes |
| FINDTIME_TIME_API_KEY | Credential the server authenticates with. | Yes |
| TIME_API_BASE_URL | Endpoint or connection string the server talks to. | Yes |
| FINDTIME_MCP_CLIENT_ID | Configuration value read at startup. | Optional |
| FINDTIME_MCP_INSTALL_ID | Configuration value read at startup. | Optional |
| FINDTIME_MCP_USAGE_TELEMETRY_URL | Endpoint or connection string the server talks to. | Yes |
| YOUR_FINDTIME_SECRET_KEY | Credential the server authenticates with. | Yes |
Kill hallucinated APIs — version-accurate, up-to-date library documentation injected straight into context.
Microsoft's official browser automation server — drive a real browser through the accessibility tree, no screenshots needed.
GitHub's official server — repos, issues, pull requests, Actions and code security, straight from your assistant.
Issue tracking at the speed of conversation — Linear's official hosted server with OAuth and zero install.
Local repository surgery — status, diffs, commits, branches and history for any repo on disk.
Timezone sanity for AI — current time anywhere and correct conversions, without the model doing date math.