mcpcentral-io avatar

Mcp Time

mcpcentral-io/mcp-time

Gives Claude access to six time-related operations: getting current time in any timezone, converting between timezones, calculating relative timestamps like "2 hours ago", finding days in a month, retrieving Unix timestamps, and determining week numbers. Built as a Cloudflare Worker that supports both stdio for local clients and streamable HTTP for remote access. Works directly with Anthropic's MCP Connector, OpenAI's Agents SDK, and Microsoft Copilot Studio without needing a separate client. Reach for this when you need Claude to handle scheduling logic, coordinate across timezones, or work with dates without hallucinating timezone math.

GitHub stars
2
tools
6
transport
STDIO, HTTP
last updated
Nov 20, 2025

Install

From registry metadata
$ npx add-mcp https://mcp.time.mcpcentral.io --name mcp-time

Run in your terminal. add-mcp asks which agents to add it to (Claude Code, Codex, Cursor and more). Add -g to install it for every project.

Review the command, arguments and environment values before installing. MCP servers run with your local permissions.

Other ways

Claude Code

$ claude mcp add --transport http mcp-time https://mcp.time.mcpcentral.io

Run in your terminal. Add --scope user to make it available in every project.

Tools

Verified live · 6 tools

Verified live against the running server on Nov 6, 2026.

current_timeReturns the current time in UTC and a specified or guessed timezone.2 params

Returns the current time in UTC and a specified or guessed timezone.

Parameters* required
formatstring
The format for the returned time string. Either a dayjs token string (e.g. "YYYY-MM-DD HH:mm:ss") or a named format: "iso8601" / "rfc3339" (ISO 8601 UTC), "unix" (epoch seconds), "unix_ms" (epoch m...default: YYYY-MM-DD HH:mm:ss
timezonestring
The IANA timezone name (e.g., "America/New_York"). Defaults to the server's guessed timezone.
relative_timeCalculates the relative time from now to a given time string.1 params

Calculates the relative time from now to a given time string.

Parameters* required
time*string
The time to compare. Format: YYYY-MM-DD HH:mm:ss
days_in_monthReturns the number of days in the month of a given date.1 params

Returns the number of days in the month of a given date.

Parameters* required
datestring
The date to check. Format: YYYY-MM-DD
get_timestampConverts a date-time string to a Unix timestamp in milliseconds.1 params

Converts a date-time string to a Unix timestamp in milliseconds.

Parameters* required
timestring
The time to convert. Format: YYYY-MM-DD HH:mm:ss
convert_timeConverts a time from a source timezone to a target timezone.3 params

Converts a time from a source timezone to a target timezone.

Parameters* required
sourceTimezone*string
The source IANA timezone name (e.g., "Asia/Shanghai").
targetTimezone*string
The target IANA timezone name (e.g., "Europe/London").
time*string
The time to convert. e.g., "2025-03-23 12:30:00".
get_week_yearReturns the week and ISO week number for a given date.1 params

Returns the week and ISO week number for a given date.

Parameters* required
datestring
The date to check. e.g., "2025-03-23"

Sponsors

Readme

MCP Time Server

A Model Context Protocol (MCP) server providing time-related tools with dual-mode support:

  • Stdio transport for local MCP clients (via npm)
  • Streamable HTTP transport for remote access (via Cloudflare Workers)

This server allows LLMs to access various date/time functions through multiple connection methods.

MCP Central Server Card: https://guide-gen.mcpcentral.io/servers/io-github-mcpcentral-io-mcp-time

Features

Provides the following MCP tools:

  • current_time: Get the current date and time in specified formats and timezones.
  • relative_time: Get a human-readable relative time string (e.g., "in 5 minutes", "2 hours ago").
  • days_in_month: Get the number of days in a specific month.
  • get_timestamp: Get the Unix timestamp (milliseconds) for a given time.
  • convert_time: Convert a time between different IANA timezones.
  • get_week_year: Get the week number and ISO week number for a given date.

Project Structure


View the full README on GitHub

Details

Repository
github.com/mcpcentral-io/mcp-time
Package
@mcpcentral/mcp-time
Transport
STDIO, HTTP
Registry
MCP registry, active
Tools verified
Nov 6, 2026

More from mcpcentral-io