Claude MarketplacesSubmit
domdomegg avatar

Time MCP Server

domdomegg/time-mcp-pypi

A straightforward utility that exposes a single tool to fetch the current UTC time in RFC 3339 format. You get one operation, get_current_utc_time, which returns timestamps like 2024-01-15T14:30:00Z. This is the kind of server you'd add when you need Claude to work with actual current timestamps rather than its training cutoff date, useful for logging, scheduling queries, or any workflow where you need to anchor responses to real time. Installation is a simple pip install and the configuration drops right into Claude Desktop's JSON config. Built as a minimal Python MCP implementation, so it's also a clean reference if you're learning the protocol.

GitHub stars
4
tools
6
transport
STDIO
last updated
Oct 26, 2025
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.SSS
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

A minimal Model Context Protocol (MCP) server built with Python.

The server provides one simple tool:

  • get_current_utc_time - Gets the current UTC date and time in RFC 3339 format

Quick start

Prerequisites:

  • Python 3.8 or later
  • Claude Desktop or another MCP-compatible client

Install and run with:

pip install time-mcp-pypi  # or from a local clone: pip install -e .
time-mcp-pypi

Configuration

To use this server with Claude Desktop, add the following to your MCP configuration file:

Windows

Add to %APPDATA%\Claude\claude_desktop_config.json:

{
  "mcpServers": {
    "time-server": {
      "command": "time-mcp-pypi"
    }
  }
}

macOS

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "time-server": {
      "command": "time-mcp-pypi"
    }
  }
}

Usage

Once configured, you can use the time tool in Claude Desktop:

  • "What's the current UTC time?"
  • "Give me an RFC 3339 timestamp"

Publishing New Versions

To publish a new version of the package:

  1. Update the version in pyproject.toml, and commit as Release x.y.z

View the full README on GitHub

Details

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

More from domdomegg