Claude MarketplacesSubmit
rog0x avatar

Time

rog0x/mcp-time-tools

Gives Claude native control over dates, times, and cron scheduling without pulling in heavy dependencies like Moment or date-fns. You get timezone conversion across IANA zones, business day calculations, date arithmetic (add/subtract days, months, years), and timestamp parsing in both directions. The cron tools are the standout: parse expressions into plain English, generate the next N run times, validate syntax, or go backwards from a description to a cron string. Also includes relative time formatting (time ago, countdowns) and duration parsing. Built entirely on JavaScript's Intl and Date APIs, so it's lean. Useful when Claude needs to schedule things, compare dates across regions, or explain when a job will run.

tools
6
transport
STDIO
last updated
Mar 22, 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

mcp-time-tools

Date, time, and timezone tools for AI agents via the Model Context Protocol (MCP).

Built entirely with native JavaScript Date and Intl APIs -- no external date libraries required.

Tools

Timezone Converter

  • convert_timezone -- Convert a date/time from one timezone to another
  • list_timezones -- List common timezones with current UTC offsets
  • current_time_multi -- Show current time in multiple timezones at once
  • time_difference -- Calculate the time difference between two timezones

Date Calculator

  • date_add_subtract -- Add or subtract days, weeks, months, or years from a date
  • date_difference -- Calculate the difference between two dates in various units
  • business_days -- Count business days between dates or add business days to a date

Cron Parser

  • parse_cron -- Parse a cron expression into a human-readable description
  • cron_next_runs -- Calculate the next N execution times for a cron expression
  • validate_cron -- Validate a cron expression and explain any errors
  • generate_cron -- Generate a cron expression from a human-readable description

View the full README on GitHub

Details

Repository
github.com/rog0x/mcp-time-tools
Category
Automation & Workflows
Package
@rog0x/mcp-time-tools
Transport
STDIO
Registry
MCP registry, active

More from rog0x

Related Automation & Workflows MCP servers

View all
1speakai avatarSpeak AIspeakai/speakai-mcpSearch recordings, summarize meetings, create clips, and automate workflows from your AI assistant.0stars
2stratoforce-ai-llc avatarStratoForce AI Revenue Intelligencestratoforce-ai-llc/stratoforce-mcp-server15 AI revenue intelligence tools for Salesforce — pipeline, deals, coaching, competitors.0stars
3treza-labs avatarTrezatreza-labs/treza-pluginBuild, run, schedule, and publish AI video pipelines to YouTube and TikTok from any MCP client.0stars
4opentweetio avatarMcpopentweetio/mcp-serverManage your Twitter/X presence from any AI assistant — schedule, threads, and more0stars
5opseraengineering avatarOpseraopseraengineering/opsera-aiOpsera AI Agent MCP server providing authenticated DevOps automation over SSE0stars
6scanbim-labs avatarRevitscanbim-labs/revit-mcpRevit model query + APS Design Automation runner.0stars