home / mcp / datetimeday mcp server

Datetimeday MCP Server

Provides date, time, and day-of-week utilities via an MCP server with tools for current date/time, relative times, and time zone conversions.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "cfdude-mcp-datetimeday": {
      "url": "https://placeholder.invalid/mcp-datetimeday"
    }
  }
}

You can use the mcp-datetimeday server to access date, time, and day of week information through your MCP client. It offers convenient tools for obtaining current date and time, calculating relative times, and converting time across time zones, all via a lightweight Python-based MCP server that you can run locally or via a containerized workflow.

How to use

You interact with this MCP server through an MCP client or integration that can call named tools. The available tools expose practical date and time utilities you can incorporate into your workflows.

How to install

Prerequisites you need on your system include Python and a compatible environment for running MCP servers.

pip install mcp-datetimeday
```
```
uv pip install mcp-datetimeday

Optionally, you can run the server using the UV runtime for development or local testing.

uv run mcp-datetimeday

You can also configure Claude to connect to this MCP server. Use Claude in code to add the MCP server, or configure Claude Desktop with the provided settings.

claude mcp add --scope user mcp-datetimeday -- uvx mcp-datetimeday

{
  "mcpServers": {
    "datetimeday": {
      "command": "uvx",
      "args": ["mcp-datetimeday"]
    }
  }
}

Additional setup notes

No authentication or API keys are shown in the usage materials. If you use it in a shared environment, consider implementing your own access controls where appropriate.

Available tools

get_datetime

Retrieve the current date and time with the day of the week, offering options to format the output and to select a time zone.

relative_time

Compute the relative time between two dates, returning phrases like 'in 3 days' or '2 weeks ago'.

days_in_month

Return the number of days in a given month and provide first/last day information for that month.

convert_time

Convert a time value between different time zones.

get_week_year

Return week-related information such as week numbers, ISO week, day of year, quarter, and related metrics.