Claude MarketplacesSubmit
yokingma avatar

Time Mcp

yokingma/time-mcp

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.

GitHub stars
66
tools
6
transport
STDIO
last updated
Jan 31, 2026
View on GitHub

Tools

6 tools

Public tool metadata for what this MCP can expose to an agent.

current_timeGet the current date and time.2 params

Get the current date and time.

Parameters* required
formatstring
The 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:ss
timezonestring
The 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
timestring
The 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
datestring
The 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
timestring
The 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
sourceTimezonestring
The source timezone. IANA timezone name, e.g. Asia/Shanghai
targetTimezonestring
The target timezone. IANA timezone name, e.g. Europe/London
timestring
Date 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
datestring
The date to get the week and isoWeek of the year. e.g. 2025-03-23

Sponsors

Promote your product hereReach 125k+ visitors monthlyPromote your product hereReach 125k+ visitors monthlyAgent CaffeineSponsoredClose your lid, come back to finished workSnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthlyWaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthlyknobsSponsoredSee your site on any phone, any day, in any language

Readme

🚀 Time MCP Server: Giving LLMs Time Awareness Capabilities

smithery badge Github Stars License Report a bug

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 time
  • get_timestamp: Get timestamp for the time
  • days_in_month: Get days in month
  • convert_time: Convert time between timezones
  • get_week_year: Get week and isoWeek of the year

Installation

Installing via Smithery

View the full README on GitHub

Details

Repository
github.com/yokingma/time-mcp
Package
time-mcp
Transport
STDIO
Registry
MCP registry, active

More from yokingma