mcp-datetimeday is a lightweight MCP server providing date, time, and day-of-week utilities through five tools:
get_datetime – Retrieve the current date, time, and day of week. Supports optional IANA timezone (e.g., UTC, America/New_York) and output formats: iso8601, unix, human, or full (default).
relative_time – Calculate relative time between two dates (e.g., "3 days ago", "in 2 weeks"). Accepts a target date and optional reference date (defaults to now).
days_in_month – Get the number of days in a given month/year, along with first and last day details. Defaults to the current month and year.
convert_time – Convert a datetime from one IANA timezone to another, with day-of-week info for both source and target timezones.
get_week_year – Retrieve week number, ISO week, ISO year, day of year, days remaining in the year, quarter, and whether the date falls on a weekend. Defaults to today.
Supports stdio (for Claude Desktop) and HTTP transport modes, and can run as a persistent server via PM2.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@mcp-datetimeday What's the current time and day of the week in Tokyo?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
A lightweight MCP server for date, time, and day of week.
pip install mcp-datetimedayOr with uv:
uv pip install mcp-datetimedayRelated MCP server: MCP Node Time
The server supports two transport modes: stdio (default) for Claude Desktop, and streamable-http for Claude Code or any HTTP-based MCP client.
Run the server as a persistent HTTP process (e.g., via PM2), then register it:
# Start the server
mcp-datetimeday --transport streamable-http --port 8105
# Register in Claude Code (user scope)
claude mcp add --transport http --scope user mcp-datetimeday http://127.0.0.1:8105/mcpclaude mcp add --scope user mcp-datetimeday -- uvx mcp-datetimedayAdd to your config (~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"datetimeday": {
"command": "uvx",
"args": ["mcp-datetimeday"]
}
}
}--transport {stdio,streamable-http} Transport protocol (default: stdio)
--port PORT Port for HTTP transport (default: 8105)
--host HOST Host for HTTP transport (default: 127.0.0.1)An ecosystem.config.cjs is included for PM2:
pm2 start ecosystem.config.cjs
pm2 saveTool | Description |
| Get current date/time with day of week first. Supports |
| Get relative time between dates (e.g., "3 days ago", "in 2 weeks") |
| Get number of days in a month with first/last day info |
| Convert time between timezones |
| Get week number, ISO week, day of year, quarter |
get_datetime(){
"day_of_week": "Monday",
"date": "2026-02-02",
"time": "16:55:22",
"timezone": "PST",
"utc_offset": "-0800",
"iso8601": "2026-02-02T16:55:22-08:00",
"unix_timestamp": 1770080122,
"human_readable": "Monday, February 02, 2026 at 04:55 PM"
}get_datetime(format="iso8601"){
"day_of_week": "Monday",
"iso8601": "2026-02-02T16:55:22-08:00"
}get_datetime(tz="UTC"){
"day_of_week": "Tuesday",
"date": "2026-02-03",
"time": "00:55:22",
"timezone": "UTC",
"utc_offset": "+0000",
"iso8601": "2026-02-03T00:55:22+00:00",
"unix_timestamp": 1738544122,
"human_readable": "Tuesday, February 03, 2026 at 12:55 AM"
}relative_time("2026-02-10"){
"target": "2026-02-10",
"target_day_of_week": "Tuesday",
"reference": "now",
"relative": "in 1 week",
"days_difference": 7,
"total_seconds": 604800
}get_week_year(){
"date": "2026-02-02",
"day_of_week": "Monday",
"day_of_week_number": 1,
"week_number": 5,
"iso_week": 6,
"iso_year": 2026,
"day_of_year": 33,
"days_remaining_in_year": 332,
"is_weekend": false,
"quarter": 1
}git clone https://github.com/cfdude/mcp-datetimeday.git
cd mcp-datetimeday
uv sync
uv run mcp-datetimedayUnclaimed servers have limited discoverability.
If you are the server author, to access and configure the admin panel.
Date calculator MCP.
Timezone MCP — wraps WorldTimeAPI (free, no auth)
A time server that keeps your AI honest about time. Real clock + drift guard, zero dependencies.
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/cfdude/mcp-datetimeday'
If you have feedback or need assistance with the MCP directory API, please join our Discord server