Summary
Gives your LLM actual time awareness through six straightforward tools. You get current_time for UTC and local timestamps, relative_time for things like "3 days ago", convert_time for timezone conversions, and utilities like days_in_month and get_week_year. It's the kind of thing you install once and forget about until Claude needs to know what time it is or calculate date differences. Runs via npx with stdio transport, so setup is just dropping a config block into your Claude Desktop, Cursor, or Windsurf settings. No external APIs, no authentication headaches. Useful anytime you're building agents that need to schedule, log timestamps, or reason about dates without hallucinating the current time.
Fastest browser for AI agents to run web automation tasks, always free.
Download Free life-time →
Notes, actions and memory. Without a meeting bot. First month 100% off.
Download for free →
belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →
Connect your Claude agent to live crypto prices and trading routes via 1inch
Get the MCP →
Block distracting apps from your iPhone permanently without a 3rd party app. Free and open source.
Block now (100% free) →Tools
Public tool metadata for what this MCP can expose to an agent.
6 tools
current_timeGet the current date and time.2 params
Get the current date and time.
Parameters* required
formatstringThe format of the time, default is empty stringone of
h:mm A · h:mm:ss A · YYYY-MM-DD HH:mm:ss · YYYY-MM-DD · YYYY-MM · MM/DD/YYYYdefault: YYYY-MM-DD HH:mm:sstimezonestringThe timezone of the time, IANA timezone name, e.g. Asia/Shanghai
relative_timeGet the relative time from now.1 params
Get the relative time from now.
Parameters* required
timestringThe time to get the relative time from now. Format: YYYY-MM-DD HH:mm:ss
days_in_monthGet the number of days in a month. If no date is provided, get the number of days in the current month.1 params
Get the number of days in a month. If no date is provided, get the number of days in the current month.
Parameters* required
datestringThe date to get the days in month. Format: YYYY-MM-DD
get_timestampGet the timestamp for the time.1 params
Get the timestamp for the time.
Parameters* required
timestringThe time to get the timestamp. Format: YYYY-MM-DD HH:mm:ss
convert_timeConvert time between timezones.3 params
Convert time between timezones.
Parameters* required
sourceTimezonestringThe source timezone. IANA timezone name, e.g. Asia/Shanghai
targetTimezonestringThe target timezone. IANA timezone name, e.g. Europe/London
timestringDate and time in 24-hour format. e.g. 2025-03-23 12:30:00
get_week_yearGet the week and isoWeek of the year.1 params
Get the week and isoWeek of the year.
Parameters* required
datestringThe date to get the week and isoWeek of the year. e.g. 2025-03-23
🚀 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
Installation
Installing via Smithery
To install time-mcp for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install @yokingma/time-mcp --client claude
Manually install (Optional)
npm install -g time-mcp
using npx
npx -y time-mcp
Running on Claude Code
To add time-mcp to Claude Code, use the following command:
claude mcp add time-mcp -- npx -y time-mcp
To verify the installation:
claude mcp list
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:
{
"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.
Featured
Fastest browser for AI agents to run web automation tasks, always free.
Download Free life-time →Notes, actions and memory. Without a meeting bot. First month 100% off.
Download for free →belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →Connect your Claude agent to live crypto prices and trading routes via 1inch
Get the MCP →Block distracting apps from your iPhone permanently without a 3rd party app. Free and open source.
Block now (100% free) →