Server facts
time-mcp
Project
- Author
- yokingma
- Repository
- github.com/yokingma/time-mcp
- License
- MIT
- Category
- Productivity
Tech
- Runtime / language
- node
- Transports
- stdio
- Remote available
- No
- Authentication
- Not specified
Activity
- GitHub stars
- 72
- Last commit
- Data as of
Tags
- agents
- llm
- mcp server
- time mcp
Overview
Time and calendar questions are the focus of time-mcp’s six tools. The current_time tool supplies the present date and time, with UTC and local time described in the documentation. For queries anchored to the present, relative_time returns relative time from now, while get_timestamp provides a timestamp for a time. The convert_time tool handles timezone changes, including the documented workflow of translating a New York time to Tokyo. Calendar queries use days_in_month, which defaults to the current month when no date is supplied, and get_week_year, which returns week-of-year and ISO week information.
The project documents several ways to connect these tools to an assistant. Claude Desktop installation is available through Smithery, while the Claude Code instructions cover adding the server, checking its connection, and asking time-related questions in conversation. Cursor and Windsurf each have configuration examples. The package supports global installation or execution through npx, runs on Node, communicates over stdio, and uses the MIT license.
time-mcp setup notes
- time-mcp records stdio only; confirm a network transport upstream before planning remote access.