Time MCP Server
Enables time awareness functionality in Windsurf (Codeium's editor), providing tools for time-related operations including current time retrieval, timezone conversions, and date calculations.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Time MCP Server what time is it in Tokyo right now?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
🚀 Time MCP Server: Giving LLMs Time Awareness Capabilities
A Model Context Protocol (MCP) server implementation that allows LLMs to have time awareness capabilities.
Tools
current_time: Get current time (UTC and local time)relative_time: Get relative timeget_timestamp: Get timestamp for the timedays_in_month: Get days in monthconvert_time: Convert time between timezonesget_week_year: Get week and isoWeek of the year
Related MCP server: Time MCP Server
Installation
Installing via Smithery
To install time-mcp for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install @yokingma/time-mcp --client claudeManually install (Optional)
npm install -g time-mcpusing npx
npx -y time-mcpRunning on Cursor
Your mcp.json file will look like this:
{
"mcpServers": {
"time-mcp": {
"command": "npx",
"args": ["-y", "time-mcp"]
}
}
}Running on Windsurf
Add this to your ./codeium/windsurf/model_config.json file:
{
"mcpServers": {
"time-mcp": {
"command": "npx",
"args": ["-y", "time-mcp"]
}
}
}License
MIT License - see LICENSE file for details.
Available Tools
6 toolsconvert_timeB
Convert time between timezones.
Inputs: sourceTimezone (required), targetTimezone (required), time (required).
current_timeB
Get the current date and time.
Inputs: format (required), timezone.
days_in_monthA
Get the number of days in a month. If no date is provided, get the number of days in the current month.
Inputs: date.
get_timestampC
Get the timestamp for the time.
Inputs: time.
get_week_yearC
Get the week and isoWeek of the year.
Inputs: date.
relative_timeB
Get the relative time from now.
Inputs: time (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
Most tools have distinct purposes, such as time conversion, current time retrieval, and timestamp generation. However, 'get_week_year' and 'relative_time' could be slightly ambiguous in scope, as both relate to temporal positioning, but their descriptions clarify the differences well.
The tools follow a consistent verb_noun pattern (e.g., convert_time, current_time) with clear, descriptive names. There are minor deviations like 'days_in_month' using plural form, but overall, the naming is highly readable and predictable.
With 6 tools, the server is well-scoped for time-related operations, covering core functionalities like conversion, current time, and date calculations. Each tool earns its place without feeling excessive or insufficient for the domain.
The toolset covers basic time operations but has notable gaps, such as missing date arithmetic (e.g., add/subtract days), time formatting, or scheduling tasks. While agents can work around this for simple queries, more complex time manipulations are not supported.
Maintenance
Related MCP Connectors
A real clock for AI agents: current time, timezone conversion, and DST facts from the IANA tzdb.
Current time, timezone conversion & date math for AI agents. On Cloudflare Workers.
Deterministic time tools for AI agents: timezone conversion, business-day math, cron interpretation.
Time and date math for AI agents: Unix timestamp conversion, DST-correct time zone conversion, durations, epoch arithmetic, cron schedules, and holiday countdowns. Eight tools, no key.
Related MCP Servers
- AlicenseBqualityDmaintenanceProvides time and timezone functionality for LLMs, enabling them to get current time information across different timezones and convert times between zones.2MIT
- AlicenseBqualityDmaintenanceProvides current time information and timezone conversion capabilities using IANA timezone names with automatic system detection. It enables LLMs to fetch local or global times and convert specific timestamps between different regions.22MIT
- AlicenseNot gradedqualityDmaintenanceProvides current time information and timezone conversion capabilities using IANA timezone names and automatic system detection. It enables LLMs to fetch current times across different regions and convert specific times between timezones.MIT
- AlicenseNot gradedqualityDmaintenanceProvides current time and timezone conversion using IANA timezone names, enabling LLMs to get system time or convert times between timezones.MIT