This server provides LLMs with comprehensive time awareness and manipulation capabilities:
Get current time - Retrieve current date and time in various formats (12/24-hour, different date formats) with optional timezone specification
Calculate relative time - Determine how much time has passed or will pass relative to a specific date/time (e.g., "2 hours ago", "in 3 days")
Convert timestamps - Generate Unix timestamps from date/time strings for precise time calculations
Get days in month - Find out how many days are in a specified month or the current month
Convert between timezones - Transform times from one IANA timezone to another (e.g., New York to Tokyo)
Get week numbers - Determine the week and ISO week numbers of the year for any given date
These tools enable LLMs to answer questions about current time, perform time calculations, handle timezone conversions, and work with various date/time formats.
Allows integration with Windsurf in Codeium, enabling time awareness capabilities for LLMs within the Codeium environment.
Click on "Install 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-mcpwhat 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:
Manually install (Optional)
using npx
Running on Claude Code
To add time-mcp to Claude Code, use the following command:
To verify the installation:
You should see time-mcp listed with a ✓ Connected status.
Usage in Claude Code
Once installed, you can use time-mcp tools in your conversations with Claude Code. For example:
"What time is it now?"
"Convert 2:00 PM from New York to Tokyo time"
"How many days are in this month?"
"What week of the year is it?"
The time-mcp server will automatically provide accurate time information to Claude.
Running on Cursor
Your mcp.json file will look like this:
Running on Windsurf
Add this to your ./codeium/windsurf/model_config.json file:
License
MIT License - see LICENSE file for details.